Developers menu

Records

Records, newest first, a year back.

GEThttps://geo.firmtape.com/v1/items

Plan GEOKey scope geoLimit 20,000 calls a month on Geo API, 100,000 on Geo TeamVersion 1.0.0Since 2026-09-17

This endpoint serves

GEO: The API, webhooks and MCP

Plan: GEO. Free to read, no account. Geo alerts, the API and Team are Geo's own plans: Geo plans. Pricing.

Parameters

Name	What it does	Default
sincequery · string	ISO 8601 UTC start; default 7 days ago
untilquery · string	ISO 8601 UTC end; default now
sectorquery · gov \| air \| gps \| sea \| internet \| ground \| space \| attention	Sector
countryquery · string	ISO 3166-1 alpha-2
feedquery · string	One feed id or several, comma separated
min_severityquery · integer	2 notable and above, 3 critical only
qquery · string	Words in the title
uidquery · string	One record id, or several comma separated; ignores the time window
limitquery · integer	1 to 1000	200
cursorquery · integer	From next in the previous answer

Response

Records; next holds the URL of the next page when more match

Field	Meaning	Unit
countinteger
nextstring \| null
history_daysinteger
itemsarray
items[].uidstring	Stable id of the record
items[].feedstring	Feed id, see /v1/sources or https://firmtape.com/geo/sources
items[].sectorgov \| air \| gps \| sea \| internet \| ground \| space \| attention
items[].typestring	new, update, level_raise, level_lower, cancel, spike, keyword or no_data
items[].categorystring
items[].severityinteger	0 info, 1 routine, 2 notable, 3 critical
items[].routineboolean	True for the records the pages hide by default
items[].countriesarray	ISO 3166-1 alpha-2
items[].regionstring \| null
items[].titlestring
items[].summarystring
items[].published_utcstring	When the source published it
items[].event_utcstring \| null	When the activity happens or starts, when the record says
items[].first_seen_utcstring	When FirmTape first read it
items[].backfillboolean	Found in the source's own history rather than caught live
items[].sourcestring	The publisher to credit
items[].urlstring	The record at its source
items[].attributionstring \| null	Paid API only: the citation the source asks for
items[].valuenumber \| null	Spikes: what was measured
items[].baselinenumber \| null	Spikes: its own normal
items[].scorenumber \| null	Spikes: value against the normal
items[].latnumber \| null	Paid API only
items[].lonnumber \| null	Paid API only
items[].factsobject	Paid API only: source-specific details

Errors

Status	Code	What to do
400		A parameter is wrong; no call is counted Fix the parameter `error` names.
401		No key, unknown key or revoked key Send a `geo` key.
403		No active API or Team plan, or a key beyond the plan's count Check the plan on the account page.
429		This month's calls are used; Retry-After says when the count resets Wait for `Retry-After`, the start of the next UTC month.

Every code: Errors.

Changes

2026-09-17 Added.

OpenAPI operation items in /docs/developers/openapi.json.

Request

curlPythonNode

curl \
  -H "Authorization: Bearer $FIRMTAPE_GEO_KEY" \
  "https://geo.firmtape.com/v1/items"

import os, requests

H = {"Authorization": f"Bearer {os.environ['FIRMTAPE_GEO_KEY']}"}
r = requests.get("https://geo.firmtape.com/v1/items", headers=H)
print(r.status_code, r.text[:500])

const r = await fetch("https://geo.firmtape.com/v1/items", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.FIRMTAPE_GEO_KEY}` },
});
console.log(r.status, await r.text());

Response

{
  "count": 1,
  "next": null,
  "history_days": 365,
  "items": [
    {
      "uid": "8f1c2a90d4b7e613",
      "feed": "faa_tfr",
      "sector": "air",
      "type": "new",
      "category": "TFR",
      "severity": 2,
      "routine": false,
      "countries": [
        "US"
      ],
      "region": null,
      "title": "Temporary flight restriction",
      "summary": "...",
      "published_utc": "2026-09-17T12:58:00Z",
      "event_utc": null,
      "first_seen_utc": "2026-09-17T13:02:00Z",
      "backfill": false,
      "source": "FAA",
      "url": "https://example.org/notice"
    }
  ]
}

Measurements of dealer positioning, never a forecast or a trade call. This page is built from FirmTape's public contract, the same files the OpenAPI document is built from; the tests hold them against the route code. Markdown: /docs/developers/geo/items.md.