Skip to content

Geography & Infrastructure


Baseline Population

The population statistics presented here are sourced from the common operational datasets (CODs), and are typically disaggregated by age and/or gender, and extend to administrative levels 1 or 2. Primary data providers include the UNFPA and OCHA country offices. These data are projections based on demographic indicators, and therefore caution should be used when comparing to population data from other sources.

Summary

Attribute Details
Data provider UNFPA, OCHA country offices
Dataset Global Subnational Population Statistics
Time series False
Update frequency Annually
Related tables Gender

Parameters Returned

The table below describes the parameters returned from this endpoint. For available query parameters, please see the API sandbox.

Parameter Description Source
resource_hdx_id Unique resource UUID on HDX Resource
gender The gender of the population group in question, set to "all" if there is no disaggregation Gender
age_range The age range of the population group in question, set to "all" if there is no disaggregation
min_age The minimum age from age_range, set to null if age_range is "all" and there is no age disaggregation
max_age The maximum age from age_range, set to null if age_range is "all" and there is no age disaggregation, or if there is no upper limit to the age range
population The number of people
reference_period_start The start date for which the data are applicable
reference_period_end The end date for which the data are applicable
location_code Location p-code, based on the ISO-3 (ISO 3166 alpha-3) standard Location
location_name Location name, based on the "short name" from the UN M49 Standard Location
admin1_code Admin 1 p-code from Common Operational Datasets Admin 1
admin1_name Admin 1 name from Common Operational Datasets or original data source Admin 1
admin2_code Admin 2 p-code from Common Operational Datasets Admin 2
admin2_name Admin 2 name from Common Operational Datasets or original data source Admin 2
admin_level Admin level Admin Level

Transformations applied

  • The table has been reshaped from wide to long: demographic-specific columns have been cast to gender, age_range, and population
  • The reference period is obtained from the HDX dataset

Usage Notes

  • Age disaggregation ranges are not consistent across countries
  • Any aggregation to a higher administrative level (e.g., admin 1 for a country where admin 2 is also available) has been taken directly from the data provided, and was not computed in the API pipeline
  • An “all” value in the gender and age_range columns indicates no disaggregation
  • age_range is expressed as "[min_age]-[max_age]", where max_age is inclusive, or "[min_age]+" for an age range starting at min_age or above