Skip to main content
All providers

Humanitarian Data Exchange (HDX)

Health

data.humdata.org

OCHA's Humanitarian Data Exchange, a CKAN catalogue of 28,000+ humanitarian datasets from UN agencies, NGOs and governments: displacement and needs assessments, administrative boundaries (COD-AB), population estimates, health and food-security indicators, with organisation, country, resource and licence metadata.

Capabilities (14)

GET /v1/data/hdx/dataset1 credit

Returns one dataset's full CKAN record: title, notes, organisation, country and location, tags, licence, dates, custom HDX fields and every resource with its URL, format, size and datastore state.

idinclude_tracking?
GET /v1/data/hdx/dataset-names1 credit

Returns a flat list of dataset names (slugs) in the catalogue, 1,000 at a time, for enumeration and mirroring rather than reading.

offset?
GET /v1/data/hdx/datasets1 credit

Full-text and faceted search over the HDX catalogue, returning matching dataset records with title, notes, organisation, country, tags, resource list, licence and dates, plus the total match count.

q?fq?sort?start?
GET /v1/data/hdx/dataset-suggest1 credit

Returns up to ten dataset suggestions for a partial query, each with name, title and the field the match came from.

qlimit?
GET /v1/data/hdx/group1 credit

Returns one group by id with its display name, description, image, package count and the datasets filed under it.

idinclude_datasets?
GET /v1/data/hdx/group-datasets1 credit

Returns the datasets filed under one group, with the same full metadata as the search route and the total count for that group.

groupq?sort?start?
GET /v1/data/hdx/groups1 credit

Returns the catalogue's groups - the country and crisis groupings HDX files datasets under - with id, display name, description, dataset count and image.

limit?offset?sort?
GET /v1/data/hdx/licenses1 credit

Returns the licence vocabulary the catalogue accepts, with id, title, family and ODC/OSD conformance flags.

No parameters
GET /v1/data/hdx/organization1 credit

Returns one contributing organisation's record: id, title, description, image, approval status, custom HDX fields and dataset count.

idinclude_extras?
GET /v1/data/hdx/organization-datasets1 credit

Returns the datasets published by one organisation, with full metadata and the organisation's total dataset count.

organizationq?sort?start?
GET /v1/data/hdx/organizations1 credit

Returns every organisation contributing to HDX - UN agencies, NGOs, governments - with id, title, description, image and dataset count.

limit?offset?sort?
GET /v1/data/hdx/resource1 credit

Returns one resource's metadata: name, description, format, size, download and landing URLs, checksum, created and last-modified dates, and the dataset it belongs to.

id
GET /v1/data/hdx/resource-search1 credit

Searches resource metadata rather than datasets, returning matching files with resource id, dataset id, name, format, size and URL, plus the total count.

queryoffset?order_by?
GET /v1/data/hdx/tags1 credit

Returns catalogue tag names matching a query, for building filters or normalising topic vocabulary.

query

Licence

After downloading a public dataset, users must follow the applicable license when using and sharing the data.

https://data.humdata.org/faqs/terms

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attribution_text.

Data from the Humanitarian Data Exchange (HDX), United Nations Office for the Coordination of Humanitarian Affairs (OCHA). Each dataset retains the licence and attribution of its contributing organisation.

Cache: up to 3600s