About

To simplify and modernize the way DTM shares data, DTM has created a publicly accessible API. It allows the humanitarian community, academia, media, government, and non-governmental organizations to use the data collected by DTM. The API only provides non-sensitive, aggregated figures, and is currently made up of two APIs: the IDP API and the HNA API. Each is documented separately below.

Scope and Data Availability Level

The DTM API shares data stored at the country, Admin 1 (states, provinces or equivalent) and Admin 2 (smaller subnational administrative areas) levels. Greater detail and disaggregation is available in other formats, while the API streamlines data sharing with a focus on simplicity and security to share relevant data with the public.

On this page

IDP API

Baseline assessments gauge population presence in an administrative area and identify sub-areas for further assessment, such as camps and camp-like settings or villages and neighbourhoods. This API shares non-sensitive IDP figures from those assessments, aggregated at the country, Admin 1 (states, provinces or equivalent) and Admin 2 (smaller subnational administrative areas) levels.

What’s New in Version 3?

Version 3 of the IDP API introduces a range of new data indicators and improvements designed to enhance the analysis of internal displacement patterns. These enhancements aim to provide deeper insight into the dynamics of displacement by incorporating more granular and meaningful data points.

Key improvements include:

  • Origin of Displacement: Identify the geographical origin or location where displacement began, offering better tracking of movement patterns.
  • Gender: Access disaggregated data by gender to support more inclusive and targeted humanitarian responses.
  • Displacement Reason: Understand the primary causes of displacement, including conflict, disasters, and other drivers.

These new indicators help improve planning, policy-making, and response strategies for stakeholders working with displacement data.

Origin of Displacement

Identifies the location where the displacement began, helping track population movements from point of origin to current location.

Gender

Offers gender-disaggregated data to support inclusive analysis and targeted humanitarian planning.

Displacement Reason*

Indicates the main cause of displacement, such as conflict, disasters, or other factors, offering context behind population movements.

*Displacement reason for the majority of the displaced population in the location.

HNA API

The Household Needs Assessment (HNA) or Multi-sectoral Needs Assessment (MSNA) API provides non-sensitive information on the needs and conditions of households in communities affected by internal displacement. While HNA assessments are conducted at the household level, the data made available via the API is aggregated to the administrative (admin) 2 level. Assessments are conducted annually; therefore, the data is presented by country and year.

What the data covers

Data is shared at admin 2 level by population category, and includes the following thematic information:

  • Location (Geography): Location of assessment up to admin 2 level
  • Demographics: Household size and age/sex composition as well as the population category (IDP, IDP returnee, or non-displaced)
  • Displacement: Reason for displacement
  • Food security and livelihoods (FSL): Food Consumption Score (FCS), Household Hunger Scale (HHS), Reduced Coping Strategy Index (rCSI), Livelihood Coping Strategy (LCS)
  • Shelter: Shelter damage and Shelter enclosure issues
  • Health: Healthcare access barriers
  • WASH: Sanitation problems
  • Multi-sector needs: Priority needs
Definitions

Internally Displaced persons (IDPs): Persons or groups of persons who have been forced to flee or to leave their homes or places of habitual residence, in particular as a result of or in order to avoid the effects of armed conflict, situations of generalized violence, violations of human rights or natural or human-made disasters, and who have not crossed an internationally recognized State border [Guiding principles on Internal Displacement, UN Doc E/CN.4/1998/53/Add.2.] [IOM, 2016].

IDP Returnee: Previously displaced people that were internally displaced before and have now returned to same location as before their displacement (IOM, 2024).

Non-Displaced: Non-displaced persons living in the same community (location) as displaced persons, either sharing public infrastructure / services with displaced persons or hosting displaced person within their household (IOM, 2024).