Get Macro Series

Fetch a single macro time-series from FRED.

country: ISO-2 lowercase code (us, eu, gb, jp)
section: indicator key - see GET /api/macro/catalog for full list

Query parameters:
start - observation start YYYY-MM-DD (activates range mode)
end - observation end YYYY-MM-DD
last_n - return N most recent observations (default: catalog default_last_n)
limit - deprecated alias for last_n
transform - comma-separated transforms; must match series unit_type:
index/money: mom_pct, yoy_pct, qoq_ann_pct
rate_pct daily: dod_bps, wow_bps
rate_pct monthly: mom_pp, yoy_pp
spread_pct: dod_bps, wow_bps
count: mom_abs, yoy_abs
Legacy aliases: mom → mom_pct, yoy → yoy_pct, 3m_ann → qoq_ann_pct
order - "desc" (newest first, default) or "asc"

Mode semantics:
last_n mode - returns the N most recent observations (default when no start given)
range mode - returns all observations in [start, end] up to max_last_n cap

Response is cached in-memory (TTL by frequency):
daily series - 6 hours
monthly series - 24 hours
quarterly series - 72 hours
Anomalous results (mid-series nulls in monthly/quarterly) are not cached.

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "data": {
        "series": {
            "country": "string",
            "section": "string",
            "fred_series_id": "string",
            "title": "string",
            "units": "string",
            "frequency": "string",
            "seasonal_adjustment": "string",
            "source": "string",
            "unit_type": "string",
            "last_updated": "string"
        },
        "data": [
            {
                "date": "string",
                "value": 0,
                "value_mom_pct": 0,
                "value_yoy_pct": 0,
                "value_qoq_ann_pct": 0,
                "value_dod_bps": 0,
                "value_wow_bps": 0,
                "value_mom_pp": 0,
                "value_yoy_pp": 0,
                "value_mom_abs": 0,
                "value_yoy_abs": 0
            }
        ],
        "meta": {
            "requested_range": {
                "start": "string",
                "end": "string"
            },
            "effective_range": {
                "start": "string",
                "end": "string"
            },
            "mode": "string",
            "last_n": 0,
            "order": "string",
            "count": 0,
            "last_observation_date": "string",
            "transforms_applied": [
                "string"
            ],
            "calculation_lookback_points": 0,
            "cache": {
                "hit": true,
                "fetched_at": "string",
                "ttl_seconds": 0
            }
        }
    },
    "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": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴503Service Unavailable

Request

Request Code Samples

Responses