Observations for a series, filtered by area and year
Primary data endpoint. Returns paginated observations for one series code, optionally filtered by a comma-separated list of M49 area codes and/or years. Source: /Series/Data. Pagination is 1-indexed; default page_size is 1000, maximum 10000. Per-row source carries custodian attribution (World Bank, WHO, etc.) - preserve in downstream display. Envelope codelists are omitted to keep payloads lean; per-row attributes and dimensions dicts are preserved.
Path parameters
Series code (e.g. SI_POV_DAY1, SH_STA_MMR, EN_ATM_CO2).
Series code (e.g. SI_POV_DAY1, SH_STA_MMR, EN_ATM_CO2).
Query parameters
Comma-separated M49 area codes (e.g. '840,156' for USA and China).
Comma-separated M49 area codes (e.g. '840,156' for USA and China).
Comma-separated years to restrict to (e.g. '2020,2021,2022').
Comma-separated years to restrict to (e.g. '2020,2021,2022').
Page number (1-indexed).
Page number (1-indexed).
Records per page, upstream cap 10000.
Records per page, upstream cap 10000.
Response
Observation rows, pagination metadata, and series code.
Example response
{
"meta": {
"endpoint": "/api/v1/fred/us/cpi",
"data_time": "2026-04-16T14:30:00Z",
"response_time": "2026-04-16T14:30:12Z",
"provider": "Sugra API v1.0.1",
"source": "sugra_crypto",
"attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
"fallback_chain": [
"sugra_crypto",
"sugra_finance"
]
}
}