> For the complete documentation index, see [llms.txt](https://docs.humdata.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.humdata.org/build/hdx-apis/hapi/available-data.md).

# Available data in HAPI

### Themes and sub-categories

HAPI organizes indicators into themes, each with sub-categories. You query a sub-category directly through its path, for example coordination-context/operational-presence.

The current themes are:

1\. **Affected people:** Humanitarian needs, refugees and persons of concern, internally displaced persons, and returnees

2\. **Coordination and context:** Conflict events, funding, national risk, and operational presence

3\. **Food security, nutrition and poverty:** Food prices, food security phases, and poverty rate

4\. **Geography and infrastructure:** Baseline population

5\. **Climate:** Rainfall

6\. **Metadata:** Supporting tables such as administrative levels, sectors, organizations, currencies, and resources

For the full and current list of sub-categories and the fields each one returns, see the API reference page or the per-theme data usage guides at [hdx-hapi.readthedocs.io](hdx-hapi.readthedocs.iohttps://hdx-hapi.readthedocs.io/en/latest/).

### Coverage

HAPI's initial coverage aligned with the HDX Data Grids, the foundational data on HDX needed to understand a humanitarian context. Because coverage changes as sources are added, the most reliable view is the live availability dashboard, which shows which indicators are available for which locations:

Data availability dashboard: <https://ocha-dap.github.io/viz-hapi-availability/>

### Update frequency

HAPI is refreshed daily from its source datasets on HDX. The update frequency of each source dataset varies from daily to weekly, yearly, or as needed, so the freshness of a given indicator depends on its source. Every row in the data sub-categories includes a resource\_hdx\_id that links back to the source dataset, where you can check its update schedule and history. The metadata sub-categories are reference tables and do not carry it.

The time period covered also varies by indicator. Conflict events, for example, go back as far as 1997, while operational presence holds only the current year.

To be notified when a source dataset changes, see [staying up to date with HDX](https://docs.humdata.org/find/staying-up-to-date-with-hdx).

<br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.humdata.org/build/hdx-apis/hapi/available-data.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.