The data for this sub-category is taken from the International Organization for Migration (IOM)'s displacement tracking matrix (DTM), which collects and analyzes data on population movements, displacements, and mobility patterns to provide timely information for humanitarian response efforts. The DTM data used in HAPI is taken from their publicly accessible API, however we note that there are many country-specific DTM datasets available on HDX, which contain more detail and disaggregation.
{{ read_yaml('data_usage_guides/subcategory_details/idps_details.yaml') }}
The table below describes the parameters returned from this endpoint. For available query parameters, please see the API sandbox.
{{ read_yaml('data_usage_guides/endpoint_parameters/idps_parameters.yaml') }}
None
- To obtain the number of IDPs per year in a given location, only the most recent reporting round per operation should be aggregated
This sub-category is populated using data compiled by UNHCR, which offers annual age- and gender-disaggregated global statistics on forcibly displaced and stateless persons, categorised by their country of origin and country of asylum. The data are sourced primarily from governments hosting these populations, UNHCR's own registration data, and occasionally data published by non-governmental organizations.
{{ read_yaml('data_usage_guides/subcategory_details/refugees_and_returnees_details.yaml') }}
The table below describes the parameters returned from this endpoint. For available query parameters, please see the API sandbox.
{{ read_yaml('data_usage_guides/endpoint_parameters/refugees_and_returnees_parameters.yaml') }}
- As this endpoint only concerns refugees and people of concern, and not IDPs or returnees, we only include statistics from the population groups "REF", "ROC", "ASY", "OIP", "IOC", "STA", "OOC", "HST", "RST", and "NAT"
- The table has been reshaped from wide to long: demographic-specific columns
have been cast to
gender,age_range, andpopulation - It is not possible to p-code based on the location information in the original data, therefore population numbers are aggregated to the national level
- The reference period is constructed using the full range of the year presented in the “Year” column of the original data
- Not all of the possible population groups are necessarily found in the UNHCR data
- An “all” value in the
genderandage_rangecolumns indicates no disaggregation age_rangeis expressed as "[min_age]-[max_age]", wheremax_ageis inclusive, or "[min_age]+" for an age range starting atmin_ageor above
This sub-category is populated using data compiled by UNHCR, which offers annual age- and gender-disaggregated global statistics on forcibly displaced and stateless persons, categorised by their country of origin and country of asylum. The data are sourced primarily from governments hosting these populations, UNHCR's own registration data, and occasionally data published by non-governmental organizations.
{{ read_yaml('data_usage_guides/subcategory_details/refugees_and_returnees_details.yaml') }}
The table below describes the parameters returned from this endpoint. For available query parameters, please see the API sandbox.
{{ read_yaml('data_usage_guides/endpoint_parameters/refugees_and_returnees_parameters.yaml') }}
- As this endpoint only concerns returnees and not the other population groups available in the UNHCR data, we only include statistics from the "RET" and "RDP" population groups
- The table has been reshaped from wide to long: demographic-specific columns
have been cast to
gender,age_range, andpopulation - It is not possible to p-code based on the location information in the original data, therefore population numbers are aggregated to the national level
- The reference period is constructed using the full range of the year presented in the “Year” column of the original data
- UNHCR is the only source for returnees in some countries and is therefore included in HDX HAPI, but if data is available from IOM, that data is preferable
- An “all” value in the
genderandage_rangecolumns indicates no disaggregation age_rangeis expressed as "[min_age]-[max_age]", wheremax_ageis inclusive, or "[min_age]+" for an age range starting atmin_ageor above
This Humanitarian Needs Overview (HNO) represents the shared understanding of OCHA Humanitarian Country Teams of people's widespread emergency needs during crises. It includes an estimate of the number of people by sector who require assistance, often referred to as People in Need (PIN), which is derived using the Joint Intersectoral Analysis Framework (JIAF).
While the HNO data is directly available on HDX, it comes from different OCHA offices and is currently not standardised. Thus, HDX HAPI obtains the PIN numbers from the HPC Tools API-based datasets on HDX.
{{ read_yaml('data_usage_guides/subcategory_details/humanitarian_needs_details.yaml') }}
The table below describes the parameters returned from this endpoint. For available query parameters, please see the API sandbox.
{{ read_yaml('data_usage_guides/endpoint_parameters/humanitarian_needs_parameters.yaml') }}
- The table has been reshaped from wide to long: the columns in the original
data of "population", "in-need", "targeted", "affected", "reached",
and "population" have been cast to a single
population_statusfield, and renamed to "all", "INN", "TGT", "AFF", and "REA", respectively - Sector values of “ALL” have been converted to “intersectoral”, as these represent the intersectoral PIN and not the disaggregated population
- Gender and disabled values of “a” have been converted to “all”
- The methodology in Yemen leads to negative population values in some admin 2 level areas. Where negative values appear they have been omitted from the API.
- The reference period is obtained from the HDX dataset
- The PIN should not be summed across sectors or population statuses, as the same people can be present across multiple groups
- For the number of people affected across all sectors, please use the PIN value where sector=intersectoral.
- An “all” value in the
gender,age_range,disable_marker, andpopulation_groupcolumns indicates no disaggregation