Population estimates: totals and median age across a geography level

Resident population and median age from the Census Bureau's Population Estimates (<vintage>/pep/charv), one estimate year (2020 to the latest published vintage). The vintage folder is the dataset; YEAR is a predicate inside it. 2020 carries an April 1 census-base row and a July 1 estimate, labelled; later years are July 1. Totals are both sexes and all ages (SEX=0, AGE=0000) with median age from the PEP_AGESEX group. geo is the nation, every state (or one, including PR), the counties of one state, or every metro area. A year past the latest is an empty answer with a reason.

Responses

🟢200OK

application/json

One row per geography (and per month in 2020), in FIPS or CBSA order.

Bodyapplication/json

Example

{
    "data": {
        "year": 0,
        "vintage": 0,
        "dataset": "string",
        "geo": "string",
        "state": "string",
        "count": 0,
        "data": [
            {
                "name": "string",
                "state_fips": "string",
                "county_fips": "string",
                "cbsa": "string",
                "pop": 0,
                "median_age": 0,
                "month": "string",
                "month_label": "string",
                "property1": "string",
                "property2": "string"
            }
        ],
        "source": "string",
        "reason": "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

Population estimates: totals and median age across a geography level

Request

Request Code Samples

Responses