Population estimates: age distribution of one sex
Changed onResident population by age from the Census Bureau's Population Estimates (<vintage>/pep/charv), one estimate year (2020 to the latest published vintage), nationally or for every state (or one). groups=bands (default) is the selected age groups (under 5, 5-9, ... 85 and over); groups=single is single years of age (under 1, age 1 ... age 85). sex is all (both sexes, default), male or female. The all-ages total and the median-age AGE code are dropped. A year past the latest is an empty answer with a reason.
Request
- Base URL: https://sugra.ai
- URL: https://sugra.ai/api/v1/census/population/estimates/age
- Auth: API key in header x-api-key
Query parameters
Estimate year (YYYY, 2020 to the latest published; required).
us (one national row) or state (every state, or one with state=).
State postal code (CA, TX, DC, PR, ...) when geo=state.
all (both sexes, default), male or female.
bands (selected age groups, default) or single (single years of age).
Response
One row per age (and per geography, and per month in 2020), in age-code order.
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",
"data_age_days": 8.532,
"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"
],
"stale_since": "2026-09-08T12:00:00Z",
"period": "2026-Q1",
"notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
}
}Changes
- info
added the optional property
//to the response with the status - info
added the optional property
//to the response with the status
- info
- info
added the non-success response with the status
- info