International demography: one year, every country

Midyear population and vital rates from the Census Bureau's International Data Base (timeseries/idb/5year) for every published GENC country in one year (1950 to 2100, including projections). Default indicators are pop, tfr, cbr, cdr, gr, medage, e0 and imr. Country codes are two-letter GENC (ISO2-compatible for the 227 published). A year after 2100 is an empty answer with a reason; a year before 1950 is a 400. Early-year rates that the Bureau has not published are null, never filled in.

Responses

🟢200OK

application/json

One row per country, in GENC code order.

Bodyapplication/json

Example

{
    "data": {
        "year": 0,
        "dataset": "string",
        "indicators": [
            "string"
        ],
        "count": 0,
        "data": [
            {
                "country": "string",
                "name": "string",
                "pop": 0,
                "tfr": 0,
                "cbr": 0,
                "cdr": 0,
                "gr": 0,
                "medage": 0,
                "e0": 0,
                "imr": 0,
                "nmr": 0,
                "dens": 0,
                "depnd": 0,
                "rni": 0,
                "births": 0,
                "deaths": 0,
                "e0_m": 0,
                "e0_f": 0,
                "imr_m": 0,
                "imr_f": 0,
                "mpop": 0,
                "fpop": 0,
                "property1": "string",
                "property2": "string"
            }
        ],
        "source": "string",
        "reason": "string",
        "note": "string",
        "property1": "string",
        "property2": "string"
    },
    "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

🔴502Bad Gateway

🔴503Service Unavailable

🔴504Gateway Timeout

International demography: one year, every country

Request

Request Code Samples

Responses