v5

latestOpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
Statistical Agencies

Total population

Total population (mid-year) by sex for one location. Backed by UN DESA World Population Prospects 2024 indicator id 49 (TPopulation). Defaults to the last 5 years ending at the current year when start_year / end_year are omitted.

get/api/v1/un-population/population

Query parameters

locationstring required

Country or area as ISO3 (USA), ISO2 (US), or M49 numeric (840). Aggregates like 900 (World) also accepted.

Country or area as ISO3 (USA), ISO2 (US), or M49 numeric (840). Aggregates like 900 (World) also accepted.

start_yearinteger nullable

Start year of the requested range (YYYY). Defaults to current_year - 5.

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.

End year of the requested range (YYYY). Defaults to current_year.

Response

Total population rows by year (and sex where applicable).

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",
    "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"
    ]
  }
}