Skip to main content
GET
List FRED observations

Authorizations

Authorization
string
header
required

GDELT Cloud API key. Send as Authorization: Bearer gdelt_sk_....

Query Parameters

series_id
string
required

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

date_start
string

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.

date_end
string

Observation window end YYYY-MM-DD.

as_of
string

Vintage date YYYY-MM-DD — return values as they were known on/before this date (point-in-time, no look-ahead).

limit
integer
default:25

Rows per page (1–100).

Required range: 1 <= x <= 100
cursor
string

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.

success
boolean
series_id
string
data
object[]
pagination
object
applied_filters
object
meta
object