Developers menu
Developers / GEO / Records, free
Markdown copyRecords, free
Records of one week or a recent range, as the pages show them.
GEThttps://firmtape.com/geo/api/items
Plan FreeNo keyLimit Free JSON, the last 30 daysVersion 1.0.0
This endpoint serves
Parameters
| Name | What it does | Default | Error |
|---|---|---|---|
| weekquery · string | ISO week on the New York calendar, e.g. 2026-W38; replaces range | ||
| rangequery · 24h | 7d | 30d | 24h, 7d or 30d when no week is given | 24h | |
| sectorquery · gov | air | gps | sea | internet | ground | space | attention | Sector | ||
| countryquery · string | ISO 3166-1 alpha-2 | ||
| notablequery · 1 | 1 keeps only notable records | ||
| limitquery · integer | Up to 1000 | 200 | |
| offsetquery · integer | Paging inside a week |
Response
Records, newest first, with week paging links
| Field | Meaning | Unit |
|---|---|---|
| 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 | |
| next_pagestring | null | ||
| prev_weekstring | null | ||
| next_weekstring | null |
OpenAPI operation freeItems in /docs/developers/openapi.json.
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/free-items.md.