Humanitarian Data Exchange (HDX)
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.
GET /v1/data/hdx/dataset1Request
CKAN dataset name (slug) or UUID.
curl "https://api.fastcrw.com/v1/data/hdx/dataset?id=ukraine" \ -H "Authorization: Bearer $FASTCRW_API_KEY"
2Response example
A sample shape. Press Run to see live data from Humanitarian Data Exchange (HDX).
{
"help": "https://data.humdata.org/api/3/action/help_show?name=package_show",
"success": true,
"result": {
"archived": false,
"caveats": "SLAC data is collected through direct observation and key informant interviews by trained field teams using a harmonised tool. While it offers timely, settlement-level insights, it is not statistically representative and reflects conditions at the time of visit. Access challenges, limited civilian presence, or security risks may constrain data completeness. In some cases, data is based solely on observation or information from neighbouring areas. Findings are intended to support operational planning, access monitoring, and response feasibility rather than replace multisectoral needs assessments.",
"creator_user_id": "b682f6f7-cd7e-4bd4-8aa7-f74138dc6313",
"data_update_frequency": "-2",
"dataset_date": "[2024-08-20T00:00:00 TO 2025-02-20T23:59:59]",
"dataset_preview": "no_preview",
"dataset_source": "AQLITY",
"has_geodata": false,
"has_showcases": false,
"id": "0b24b3cf-6463-48c7-8201-7e6d87f629d6",
"is_requestdata_type": false,
"isopen": false,
"last_modified": "2025-05-08T09:25:22.552404",
"license_id": "cc-by-igo",
"license_title": "Creative Commons Attribution for Intergovernmental Organisations (CC BY-IGO)",
"license_url": "http://creativecommons.org/licenses/by/3.0/igo/legalcode",
"maintainer": "bdf58358-e241-4e77-93b0-04787efe85d3",
"metadata_created": "2025-04-30T07:38:52.750257",
"metadata_modified": "2025-05-08T09:26:53.239628",
"methodology": "Direct Observational Data/Anecdotal Data",
"name": "ukraine",
"notes": "This dataset is part of AQLITY’s Security, Logistics, Access and Cash Feasibility (SLAC) Monitoring tool. It captures granular, settlement-level data collected through direct observation and key informant interviews across eastern Ukraine. The dataset includes information on population presence and vulnerability, access constraints, availability of basic services, market functionality, infrastructure damage, and cash feasibility. Each record reflects a specific assessment round in a given settlement and contributes to tracking humanitarian access and service availability in hard-to-reach and high-risk areas. The dataset is intended to provide operational data for humanitarian organisations and prompt further assessment and/or principled response.",
"num_resources": 1,
"num_tags": 10,
"organization": {
"id": "03087411-b3c8-44c4-8b9f-e6e6123633b3",
"name": "aqlity",
"title": "AQLITY",
"type": "organization",
"description": "AQLITY is an Irish humanitarian organization specializing in data-informed response in hard-to-reach areas. It generates and analyzes frontline information to support timely, evidence-based, and accountable humanitarian action.",
"image_url": "",
"created": "2025-04-02T06:55:25.604044",
"is_organization": true,
"approval_status": "approved",
"state": "active"
},
"owner_org": "03087411-b3c8-44c4-8b9f-e6e6123633b3",
"package_creator": "berylnyamgeroh",
"pageviews_last_14_days": 38,
"private": false,
"qa_completed": false,
"solr_additions": "{\"countries\": [\"Ukraine\"]}",
"state": "active",
"subnational": "1",
"title": "Ukraine - Frontline Monitoring",
"total_res_downloads": 272,
"type": "dataset",
"url": null,
"version": null,
"groups": [
{
"description": "",
"display_name": "Ukraine",
"id": "ukr",
"image_display_url": "",
"name": "ukr",
"title": "Ukraine"
}
],
"resources": [
{
"alt_url": "https://data.humdata.org/dataset/0b24b3cf-6463-48c7-8201-7e6d87f629d6/resource/ed35c7f7-ec33-4ead-b3c1-e58632032262/download/",
"cache_last_updated": null,
"cache_url": null,
"created": "2025-05-08T09:25:22.777765",
"dataset_preview_enabled": false,
"datastore_active": false,
"description": "",
"download_url": "https://data.humdata.org/dataset/0b24b3cf-6463-48c7-8201-7e6d87f629d6/resource/ed35c7f7-ec33-4ead-b3c1-e58632032262/download/aqlity_dataset-082024_022025.xlsx",
"format": "XLSX",
"fs_check_info": "[{\"state\": \"processing\", \"message\": \"The processing of the file structure check has started\", \"timestamp\": \"2025-05-08T09:25:22.347155\"}, {\"state\": \"success\", \"message\": \"File structure check completed\", \"timestamp\": \"2025-05-08T09:25:26.416692\", \"sheet_changes\": [], \"hxl_proxy_response\": {\"url_or_filename\": \"https://data.humdata.org/dataset/0b24b3cf-6463-48c7-8201-7e6d87f629d6/resource/ed35c7f7-ec33-4ead-b3c1-e58632032262/download/aqlity_dataset-082024_022025.xlsx\", \"format\": \"XLSX\", \"sheets\": [{\"name\": \"code_book\", \"is_hidden\": false, \"nrows\": 99, \"ncols\": 5, \"has_merged_cells\": true, \"is_hxlated\": false, \"header_hash\": \"4fd701e8675add6f94c827e3d7d94f98\", \"hxl_header_hash\": null, \"headers\": [\"Block 1: Civilian Demographics\", \"\", \"Answer options\"], \"hxl_headers\": null}, {\"name\": \"SLAC all data\", \"is_hidden\": false, \"nrows\": 288, \"ncols\": 99, \"has_merged_cells\": true, \"is_hxlated\": false, \"header_hash\": \"f6d785c2c6fa8f71c4c24bf45de274f3\", \"hxl_header_hash\": null, \"headers\": [\"Date\", \"Administrative Classification\", \"\", \"\", \"\", \"Block 1: Civilian Demographics\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"Block 2: Safety and Security\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"Block 3: Access\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"Block 4: Logistics\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"Block 5: Market and Financial Services\"], \"hxl_headers\": null}, {\"name\": \"082024_092024\", \"is_hidden\": false, \"nrows\": 77, \"ncols\": 99, \"has_merged_cells\": true, \"is_hxlated\": false, \"header_hash\": \"f6d785c2c6fa8f71c4c24bf45de274f3\", \"hxl_header_hash\": null, \"headers\": [\"Date\", \"Administrative Classification\", \"\", \"\", \"\", \"Block 1: Civilian Demographics\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"Block 2: Safety and Security\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"Block 3: Access\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", \"\", …",
"hash": "",
"hdx_rel_url": "/dataset/0b24b3cf-6463-48c7-8201-7e6d87f629d6/resource/ed35c7f7-ec33-4ead-b3c1-e58632032262/download/aqlity_dataset-082024_022025.xlsx",
"id": "ed35c7f7-ec33-4ead-b3c1-e58632032262",
"last_modified": "2025-05-08T09:25:22.552404",
"metadata_modified": "2025-05-08T09:25:26.551244",
"microdata": false,
"mimetype": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"mimetype_inner": null,
"name": "AQLITY_dataset 082024_022025.xlsx",
"originalHash": "8750915",
"p_coded": false,
"package_id": "0b24b3cf-6463-48c7-8201-7e6d87f629d6",
"pii": "false",
"position": 0,
"resource_type": "file.upload",
"size": 282455,
"state": "active",
"url": "https://data.humdata.org/dataset/0b24b3cf-6463-48c7-8201-7e6d87f629d6/resource/ed35c7f7-ec33-4ead-b3c1-e58632032262/download/aqlity_dataset-082024_022025.xlsx",
"url_type": "upload"
}
],
"tags": [
{
"display_name": "affected population",
"id": "9f9d19d4-901f-4b57-b781-e6b2b56e2138",
"name": "affected population",
"state": "active",
"vocabulary_id": "b891512e-9516-4bf5-962a-7a289772a2a1"
},
{
"display_name": "baseline population",
"id": "db8205e9-b61c-4df7-a987-1a2658ed8666",
"name": "baseline population",
"state": "active",
"vocabulary_id": "b891512e-9516-4bf5-962a-7a289772a2a1"
},
{
"display_name": "cash based interventions-cbi",
"id": "3fdf3530-7f85-47c3-877b-5b87390d6e5c",
"name": "cash based interventions-cbi",
"state": "active",
"vocabulary_id": "b891512e-9516-4bf5-962a-7a289772a2a1"
},
{
"display_name": "complex emergency-conflict-security",
"id": "964a4ed8-0527-4b90-b929-ccea14fc2851",
"name": "complex emergency-conflict-security",
"state": "active",
"vocabulary_id": "b891512e-9516-4bf5-962a-7a289772a2a1"
},
{
"display_name": "demographics",
"id": "7aa60d26-5c83-4c50-80d2-0b944fe80122",
"name": "demographics",
"state": "active",
"vocabulary_id": "b891512e-9516-4bf5-962a-7a289772a2a1"
},
{
"display_name": "facilities-infrastructure",
"id": "e45272d8-6b73-4b8d-bb08-e880f8900df5",
"name": "facilities-infrastructure",
"state": "active",
"vocabulary_id": "b891512e-9516-4bf5-962a-7a289772a2a1"
},
{
"display_name": "humanitarian access",
"id": "be991471-7303-4923-9c75-69e866fab7ae",
"name": "humanitarian access",
"state": "active",
"vocabulary_id": "b891512e-9516-4bf5-962a-7a289772a2a1"
},
{
"display_name": "markets",
"id": "b62086cd-553f-4464-9cd3-9efb487203fe",
"name": "markets",
"state": "active",
"vocabulary_id": "b891512e-9516-4bf5-962a-7a289772a2a1"
},
{
"display_name": "needs assessment",
"id": "9b4c3273-e3c3-4727-9adf-6760644993d0",
"name": "needs assessment",
"state": "active",
"vocabulary_id": "b891512e-9516-4bf5-962a-7a289772a2a1"
},
{
"display_name": "services",
"id": "9f54b0e4-78df-4939-a2a1-892aaf4396ce",
"name": "services",
"state": "active",
"vocabulary_id": "b891512e-9516-4bf5-962a-7a289772a2a1"
}
],
"relationships_as_subject": [],
"relationships_as_object": [],
"due_date": null,
"is_fresh": false,
"update_status": "unknown",
"x_resource_grouping": []
}
}Attribution: 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.
Licence: After downloading a public dataset, users must follow the applicable license when using and sharing the data.
Ask with this source
A prompt for your agent that names this source and how to call it through the crw MCP.
One dataset
Use Humanitarian Data Exchange (HDX) (hdx) from fastCRW Pergamon, capability "One dataset" (dataset). You hold a dataset name or id and need its metadata and the list of files inside it. Example options: id=ukraine. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "hdx" and capability "dataset". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Dataset names
Use Humanitarian Data Exchange (HDX) (hdx) from fastCRW Pergamon, capability "Dataset names" (dataset-names). You want to enumerate or diff the catalogue of dataset slugs without pulling metadata. Example options: offset=1000. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "hdx" and capability "dataset-names". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Search datasets
Use Humanitarian Data Exchange (HDX) (hdx) from fastCRW Pergamon, capability "Search datasets" (datasets). You are looking for humanitarian datasets by keyword, country, format or organisation and do not yet have an id. Example options: q=ukraine, fq=groups:afg, sort=metadata_modified desc. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "hdx" and capability "datasets". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>
Dataset autocomplete
Use Humanitarian Data Exchange (HDX) (hdx) from fastCRW Pergamon, capability "Dataset autocomplete" (dataset-suggest). You have a partial dataset title or slug from a user and need the full names it could be. Example options: q=ukr. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "hdx" and capability "dataset-suggest". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>