By using the HDX HAPI, you acknowledge that you have read, understood, and agreed to these terms of service.
Welcome to the HDX Humanitarian API (HDX HAPI), a digital service provided by the Centre for Humanitarian Data. HDX HAPI is designed to disseminate key humanitarian datasets in a standardized and programmatically accessible format, specifically tailored for countries with active humanitarian response plans.
By accessing or utilizing HDX HAPI, you, the user, agree to comply with and be legally bound by these terms and conditions in full. Please read these terms carefully before using the API. If you disagree with any part of the terms, you must not use this service.
To ensure equitable access and maintain optimal performance for all users, the API imposes a restriction on the maximum number of entries retrievable per API call, capped at 10,000 entries.
We regulate the frequency of API calls to prevent overloading our systems and ensure reliable service for all users. Users are kindly requested to moderate their rate of requests to 1 per second. Further details on rate limiting practices will be provided upon request.
Users are prohibited from interfering with or disrupting the APIs, as well as any servers or networks connected to the APIs. Such interference includes actions that compromise the integrity, performance, or reliability of the service.
The Office for the Coordination of Humanitarian Affairs (OCHA) is committed to continuously improving the HAPI service. As part of this effort, OCHA may log API calls and analyze usage patterns. Users are required to include the ‘app identifier’ parameters in their API requests to facilitate tracking and analysis for statistical and performance evaluation purposes. OCHA also uses third-party analytics services, including Google Analytics, Mixpanel and Hotjar. OCHA does not send identifying information (including names, usernames, or email addresses) to Google Analytics, Mixpanel or Hotjar. Use and retention of the data collected from the HDX platform is governed by these services’ respective Terms of Use.
The data and information available through HDX HAPI do not represent the opinions of OCHA or the United Nations, nor do they imply any endorsement. This extends to opinions regarding the legal status of any country, territory, city, or area, including its authorities and the delineation of its frontiers or boundaries.
Should you have any inquiries or require further assistance, please do not hesitate to contact hdx@un.org.