Statistical Agencies
Age structure and dependency ratios
Changed onComposite covering age structure from UN DESA World Population Prospects 2024: id 46 (PopByAge5AndSex - population by 5-year age groups and sex), id 83 (ChildDepRatio), id 84 (OldAgeDepRatio), and id 86 (TotalDepRatio). Merged into one payload; split on indicatorId when consuming.
get/api/v1/un-population/age-structure
Request
- Base URL: https://sugra.ai
- URL: https://sugra.ai/api/v1/un-population/age-structure
- Auth: API key in header x-api-key
Query parameters
locationstring required
Country or area as ISO3 (USA), ISO2 (US), or M49 numeric (840).
start_yearinteger nullable
Start year of the requested range (YYYY). Defaults to current_year - 5.
end_yearinteger nullable
End year of the requested range (YYYY). Defaults to current_year.
Response
Population by 5-year age groups plus dependency ratios.
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 non-success response with the status
- info
- info
added the optional property
/to the response with the status
- info