Coordination & Context

Get the list of organizations present and in which humanitarian sectors they are working

get

OCHA's 3W (Who is doing What Where) Operational Presence data provides information about which organizations are working in different locations affected by a crisis. See the more detailed technical HDX HAPI documentation, and the original OCHA 3W source website.

Query parameters

app_identifierstring · max: 512 · nullableRequired

base64 encoded application name and email, as in base64("app_name:email"). This value can also be passed in the X-HDX-HAPI-APP-IDENTIFIER header. See the encoded_app_identifier endpoint.

sector_codestring · max: 512 · nullableOptional

Filter the response by sector codes, which describe the humanitarian sector to which the operational presence applies. See the sector endpoint for details.

sector_namestring · max: 512 · nullableOptional

Filter the response by sector names, which describe the humanitarian sector to which the operational presence applies. See the sector endpoint for details.

org_acronymstring · max: 32 · nullableOptional

Filter the response by the acronym of the organization to which the operational presence applies. See the org endpoint for details.

org_namestring · max: 512 · nullableOptional

Filter the response by the name of the organization to which the operational presence applies. See the org endpoint for details.

has_hrpboolean · nullableOptional

Filter the response by the has_hrp flag. The has_hrp flag indicates whether a country has a Humanitarian Response Plan.

in_ghoboolean · nullableOptional

Filter the response by the in_gho flag. The in_gho flag indicates whether a country is in the Global Humanitarian Overview.

start_datestring · nullableOptional

Filter entries to include rows where the reference period overlaps with or extends beyond this date, e.g. 2020, 2020-01, 2020-01-01 or 2020-01-01T00:00:00

end_datestring · nullableOptional

Filter entries to include rows where the reference period overlaps with or begins prior to this date, e.g. 2020, 2020-01, 2020-01-01, 2020-01-01 or 2020-01-01T23:59:59

location_codestring · max: 128 · nullableOptional

Filter the response by a location (typically a country). The location codes use the ISO-3 (ISO 3166 alpha-3) codes. See the location endpoint for details.

location_namestring · max: 512 · nullableOptional

Filter the response by a location (typically a country). The location names are based on the "short name" from the UN M49 Standard. See the location endpoint for details.

admin1_codestring · max: 128 · nullableOptional

Filter the response by the 1st subnational administrative divisions. The admin1 codes refer to the p-codes in the Common Operational Datasets. See the admin1 endpoint for details.

admin1_namestring · max: 512 · nullableOptional

Filter the response by the 1st subnational administrative divisions. The admin1 names refer to either the Common Operational Datasets or those provided in the original data source. See the admin1 endpoint for details.

admin2_codestring · max: 128 · nullableOptional

Filter the response by the 2nd subnational administrative divisions. The admin2 codes refer to the p-codes in the Common Operational Datasets. See the admin2 endpoint for details.

admin2_namestring · max: 512 · nullableOptional

Filter the response by the 2nd subnational administrative divisions. The admin2 names refer to either the Common Operational Datasets or those provided in the original data source. See the admin2 endpoint for details.

admin_levelstring · enum · nullableOptional

Filter the response by admin level.

Possible values:

output_formatstring · enumOptionalDefault: jsonPossible values:

limitinteger · max: 10000Optional

Maximum number of records to return. The system will not return more than 10,000 records.

Default: 10000Example: 100

offsetintegerOptional

Number of records to skip in the response. Use in conjunction with the limit parameter to paginate.

Default: 0

Responses

200

Successful Response

application/json

400

Bad Request

application/json

422

Validation Error

application/json

500

Internal Server Error

application/json

get/api/v2/coordination-context/operational-presence

GET /api/v2/coordination-context/operational-presence?app_identifier=text HTTP/1.1
Host: hapi.humdata.org
Accept: */*

{
  "data": [
    {
      "location_code": "text",
      "location_name": "text",
      "admin1_code": "text",
      "admin1_name": "text",
      "admin2_code": "text",
      "admin2_name": "text",
      "admin_level": 1,
      "resource_hdx_id": "text",
      "org_acronym": "text",
      "org_name": "text",
      "sector_code": "text",
      "sector_name": "text",
      "reference_period_start": "2026-01-01T00:00:00.000Z",
      "reference_period_end": "2026-01-01T00:00:00.000Z",
      "org_type_code": "text",
      "org_type_description": "text"
    }
  ]
}

Get funding data

get

OCHA's funding data from the Financial Tracking Service provides information on humanitarian aid contributions. See the more detailed technical HDX HAPI documentation, and the original FTS source website.

Query parameters

app_identifierstring · max: 512 · nullableRequired

base64 encoded application name and email, as in base64("app_name:email"). This value can also be passed in the X-HDX-HAPI-APP-IDENTIFIER header. See the encoded_app_identifier endpoint.

appeal_codestring · max: 64 · nullableOptional

Filter the response by a unique code given by FTS to each appeal

appeal_typestring · max: 64 · nullableOptional

Filter the response by the type of the appeal, such as flash or HRP

location_codestring · max: 128 · nullableOptional

Filter the response by a location (typically a country). The location codes use the ISO-3 (ISO 3166 alpha-3) codes. See the location endpoint for details.

location_namestring · max: 512 · nullableOptional

Filter the response by a location (typically a country). The location names are based on the "short name" from the UN M49 Standard. See the location endpoint for details.

has_hrpboolean · nullableOptional

Filter the response by the has_hrp flag. The has_hrp flag indicates whether a country has a Humanitarian Response Plan.

in_ghoboolean · nullableOptional

Filter the response by the in_gho flag. The in_gho flag indicates whether a country is in the Global Humanitarian Overview.

start_datestring · nullableOptional

Filter entries to include rows where the reference period overlaps with or extends beyond this date, e.g. 2020, 2020-01, 2020-01-01 or 2020-01-01T00:00:00

end_datestring · nullableOptional

Filter entries to include rows where the reference period overlaps with or begins prior to this date, e.g. 2020, 2020-01, 2020-01-01, 2020-01-01 or 2020-01-01T23:59:59

output_formatstring · enumOptionalDefault: jsonPossible values:

limitinteger · max: 10000Optional

Maximum number of records to return. The system will not return more than 10,000 records.

Default: 10000Example: 100

offsetintegerOptional

Number of records to skip in the response. Use in conjunction with the limit parameter to paginate.

Default: 0

Responses

200

Successful Response

application/json

400

Bad Request

application/json

422

Validation Error

application/json

500

Internal Server Error

application/json

get/api/v2/coordination-context/funding

GET /api/v2/coordination-context/funding?app_identifier=text HTTP/1.1
Host: hapi.humdata.org
Accept: */*

{
  "data": [
    {
      "resource_hdx_id": "text",
      "appeal_code": "text",
      "appeal_name": "text",
      "appeal_type": "text",
      "requirements_usd": 1,
      "funding_usd": 1,
      "funding_pct": 1,
      "location_code": "text",
      "location_name": "text",
      "reference_period_start": "2026-01-01T00:00:00.000Z",
      "reference_period_end": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Get the list of conflict events

get

Armed Conflict Location & Events Data from ACLED. See the more detailed technical HDX HAPI documentation, and the original ACLED source website.

Query parameters

app_identifierstring · max: 512 · nullableRequired

base64 encoded application name and email, as in base64("app_name:email"). This value can also be passed in the X-HDX-HAPI-APP-IDENTIFIER header. See the encoded_app_identifier endpoint.

event_typestring · enum · nullableOptional

Filter the response by the ACLED event-type categories (non-mutually exclusive), available values are described here.

Possible values:

has_hrpboolean · nullableOptional

Filter the response by the has_hrp flag. The has_hrp flag indicates whether a country has a Humanitarian Response Plan.

in_ghoboolean · nullableOptional

Filter the response by the in_gho flag. The in_gho flag indicates whether a country is in the Global Humanitarian Overview.

start_datestring · nullableOptional

Filter entries to include rows where the reference period overlaps with or extends beyond this date, e.g. 2020, 2020-01, 2020-01-01 or 2020-01-01T00:00:00

end_datestring · nullableOptional

Filter entries to include rows where the reference period overlaps with or begins prior to this date, e.g. 2020, 2020-01, 2020-01-01, 2020-01-01 or 2020-01-01T23:59:59

location_codestring · max: 128 · nullableOptional

Filter the response by a location (typically a country). The location codes use the ISO-3 (ISO 3166 alpha-3) codes. See the location endpoint for details.

location_namestring · max: 512 · nullableOptional

Filter the response by a location (typically a country). The location names are based on the "short name" from the UN M49 Standard. See the location endpoint for details.

admin1_codestring · max: 128 · nullableOptional

Filter the response by the 1st subnational administrative divisions. The admin1 codes refer to the p-codes in the Common Operational Datasets. See the admin1 endpoint for details.

admin1_namestring · max: 512 · nullableOptional

Filter the response by the 1st subnational administrative divisions. The admin1 names refer to either the Common Operational Datasets or those provided in the original data source. See the admin1 endpoint for details.

admin2_codestring · max: 128 · nullableOptional

Filter the response by the 2nd subnational administrative divisions. The admin2 codes refer to the p-codes in the Common Operational Datasets. See the admin2 endpoint for details.

admin2_namestring · max: 512 · nullableOptional

Filter the response by the 2nd subnational administrative divisions. The admin2 names refer to either the Common Operational Datasets or those provided in the original data source. See the admin2 endpoint for details.

admin_levelstring · enum · nullableOptional

Filter the response by admin level.

Possible values:

output_formatstring · enumOptionalDefault: jsonPossible values:

limitinteger · max: 10000Optional

Maximum number of records to return. The system will not return more than 10,000 records.

Default: 10000Example: 100

offsetintegerOptional

Number of records to skip in the response. Use in conjunction with the limit parameter to paginate.

Default: 0

Responses

200

Successful Response

application/json

400

Bad Request

application/json

422

Validation Error

application/json

500

Internal Server Error

application/json

get/api/v2/coordination-context/conflict-events

GET /api/v2/coordination-context/conflict-events?app_identifier=text HTTP/1.1
Host: hapi.humdata.org
Accept: */*

{
  "data": [
    {
      "location_code": "text",
      "location_name": "text",
      "admin1_code": "text",
      "admin1_name": "text",
      "admin2_code": "text",
      "admin2_name": "text",
      "admin_level": 1,
      "resource_hdx_id": "text",
      "event_type": "civilian_targeting",
      "events": 1,
      "fatalities": 1,
      "reference_period_start": "2026-01-01T00:00:00.000Z",
      "reference_period_end": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Get national risk data

get

European Commission national risk data from the INFORM-risk framework. See the more detailed technical HDX HAPI documentation, and the original INFORM-risk source website.

Query parameters

app_identifierstring · max: 512 · nullableRequired

base64 encoded application name and email, as in base64("app_name:email"). This value can also be passed in the X-HDX-HAPI-APP-IDENTIFIER header. See the encoded_app_identifier endpoint.

risk_classstring · enum · nullableOptional

Filter the response by the INFORM risk class, available values are described here.

Possible values:

global_rank_mininteger · nullableOptional

Filter the response by a lower bound for the Global Rank.

global_rank_maxinteger · nullableOptional

Filter the response by an upper bound for the Global Rank.

overall_risk_minnumber · nullableOptional

Filter the response by a lower bound for the Overall Risk.

overall_risk_maxnumber · nullableOptional

Filter the response by an upper bound for the Overall Risk.

hazard_exposure_risk_minnumber · nullableOptional

Filter the response by a lower bound for the Hazard Exposure Risk.

hazard_exposure_risk_maxnumber · nullableOptional

Filter the response by an upper bound for the Hazard Exposure Risk.

vulnerability_risk_minnumber · nullableOptional

Filter the response by a lower bound for the Vulnerability Risk.

vulnerability_risk_maxnumber · nullableOptional

Filter the response by an upper bound for the Vulnerability Risk.

coping_capacity_risk_minnumber · nullableOptional

Filter the response by a lower bound for the Coping Capacity Risk.

coping_capacity_risk_maxnumber · nullableOptional

Filter the response by a lower bound for the Coping Capacity Risk.

location_codestring · max: 128 · nullableOptional

Filter the response by a location (typically a country). The location codes use the ISO-3 (ISO 3166 alpha-3) codes. See the location endpoint for details.

location_namestring · max: 512 · nullableOptional

Filter the response by a location (typically a country). The location names are based on the "short name" from the UN M49 Standard. See the location endpoint for details.

has_hrpboolean · nullableOptional

Filter the response by the has_hrp flag. The has_hrp flag indicates whether a country has a Humanitarian Response Plan.

in_ghoboolean · nullableOptional

Filter the response by the in_gho flag. The in_gho flag indicates whether a country is in the Global Humanitarian Overview.

start_datestring · nullableOptional

Filter entries to include rows where the reference period overlaps with or extends beyond this date, e.g. 2020, 2020-01, 2020-01-01 or 2020-01-01T00:00:00

end_datestring · nullableOptional

Filter entries to include rows where the reference period overlaps with or begins prior to this date, e.g. 2020, 2020-01, 2020-01-01, 2020-01-01 or 2020-01-01T23:59:59

output_formatstring · enumOptionalDefault: jsonPossible values:

limitinteger · max: 10000Optional

Maximum number of records to return. The system will not return more than 10,000 records.

Default: 10000Example: 100

offsetintegerOptional

Number of records to skip in the response. Use in conjunction with the limit parameter to paginate.

Default: 0

Responses

200

Successful Response

application/json

400

Bad Request

application/json

422

Validation Error

application/json

500

Internal Server Error

application/json

get/api/v2/coordination-context/national-risk

GET /api/v2/coordination-context/national-risk?app_identifier=text HTTP/1.1
Host: hapi.humdata.org
Accept: */*

{
  "data": [
    {
      "risk_class": "1",
      "global_rank": 1,
      "overall_risk": 1,
      "hazard_exposure_risk": 1,
      "vulnerability_risk": 1,
      "coping_capacity_risk": 1,
      "meta_missing_indicators_pct": 1,
      "meta_avg_recentness_years": 1,
      "reference_period_start": "2026-01-01T00:00:00.000Z",
      "reference_period_end": "2026-01-01T00:00:00.000Z",
      "resource_hdx_id": "text",
      "location_code": "text",
      "location_name": "text"
    }
  ]
}