Get Macro Multi - Sugra API

Fetch multiple macro series in one request.

series: comma-separated list of country/section, max 5
e.g. ?series=us/cpi,us/unrate,us/gdp
start: observation start YYYY-MM-DD (range mode)
end: observation end YYYY-MM-DD
last_n: max observations per series, newest first (takes precedence over limit)
limit: deprecated alias for last_n
transform: comma-separated transforms; each series accepts only the
supported_transforms listed for its key in GET /api/v1/macro/catalog
(mom_* compare with the previous observation, dod_bps with the
previous observation of a daily or weekly series, yoy_* with the
same date a year earlier, wow_bps with one week earlier)
order: "desc" (newest first, default) or "asc"

Each series is fetched concurrently. Partial failures are isolated - they appear
in the errors dict and do not affect successful results.
FredClient semaphore limits total parallel FRED connections to 3.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Batch results for up to 5 macro series, with per-series errors isolated.

Bodyapplication/json

Example

{
    "data": {
        "results": {
            "property1": "string",
            "property2": "string"
        },
        "errors": {
            "property1": "string",
            "property2": "string"
        },
        "requested": [
            "string"
        ],
        "count": 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",
        "data_age_days": 0,
        "source": "string",
        "attribution": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true,
        "stale": true,
        "stale_since": "string",
        "period": "string",
        "notes": "string"
    }
}

🟠401Unauthorized

🟠422Parameter Error

🟠429

🔴500Server Error

🔴502Bad Gateway

🔴503Service Unavailable

🔴504Gateway Timeout