v1
latestOpenAPI 3.0.32026-07-226744340.8 KBList FRED observations
Point-in-time observations for a single series. Optional as_of selects the vintage known on/before that date (ALFRED — no look-ahead); otherwise the latest vintage is returned. When no dates are given, returns the most-recent observations across the full available history, bounded by limit — page further back via next_cursor; there is no fixed trailing window. Discover a valid series_id via GET /api/v2/macro/series or the catalog: https://docs.gdeltcloud.com/api-reference/macro-series-catalog. Requires a plan with Macro & economic data access (can_use_macro) — the Corporate & Supply Chain and Global Intelligence plans.
Query parameters
FRED series ID (required). To discover valid IDs, call GET /api/v2/macro/series with no filters, or see the catalog: https://docs.gdeltcloud.com/api-reference/macro-series-catalog
Observation window start YYYY-MM-DD. Defaults to the beginning of the series; with no start date the response returns the most-recent observations by limit, with older history reachable via next_cursor.
Observation window end YYYY-MM-DD.
Vintage date YYYY-MM-DD — return values as they were known on/before this date (point-in-time, no look-ahead).
Rows per page (1–100).
Pagination cursor (offset) from a prior response's next_cursor.
Response
A page of observations for the series, most recent first. Each row: date, value, vintage (the realtime_start the value became known). Echoes series_id and includes the FRED non-endorsement meta.