Skip to content

HDX HAPI

The HDX Humanitarian API (HDX HAPI) is a way to access standardised indicators from multiple sources to automate workflows and visualisations.

HDX HAPI is in beta phase, and we are seeking feedback. To share your thoughts or join our Slack channel, send an email to hdx@un.org.

Data Coverage

Thematically, HAPI aims to include all the data subcategories from the HDX data grids. Geographically, HAPI focuses on all countries that have a humanitarian response plan but also includes other countries for which the data is available. The Data Availability Table details the data coverage that we have achieved at present, and to which administrative level the data is available: national (admin 0), admin 1, or admin 2.

Accessing the Data

You can find out more about HDX HAPI in the Getting Started and API documentation pages.

There are also HDX HAPI datasets on HDX containing the data available from the API. Some datasets have warning and error columns. Warnings typically indicate corrections have been made to the data or show things to look out for. Rows with only warnings are considered complete, and are available from the API. Errors usually mean that the data is incomplete or unusable. Rows with any errors are not present in the API but have been included for transparency.

Latest Changes

Note: this is only a 10-line snippet, for full details please refer to the complete changelog.

2025-02-18

  • Aligned category and sub-category endpoint names in the docs with HDX data grids
  • affected-people/refugees -> affected-people/refugees-persons-of-concern
  • population-social/population -> geography-infrastructure/baseline-population
  • coordination-context/conflict-event -> coordination-context/conflict-events
  • food/food-security -> food-security-nutrition-poverty/food-security
  • food/food-price -> food-security-nutrition-poverty/food-prices-market-monitor
  • population-social/poverty-rate -> food-security-nutrition-poverty/poverty-rate
  • population-social/population -> geography-infrastructure/baseline-population

Terms Of Use

Use of HDX HAPI is governed by the HDX HAPI Terms of Use.

FAQS

Please refer to the landing page for non-technical FAQs