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
, andpopulation
- 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
andage_range
columns indicates no disaggregation age_range
is expressed as "[min_age
]-[max_age
]", wheremax_age
is inclusive, or "[min_age
]+" for an age range starting atmin_age
or above