WHO GHO
World Health Organization Global Health Observatory — 3,095 indicators with country, region, year and disaggregation filters plus uncertainty intervals.
Countries
WHO Global Health Observatory — the COUNTRY dimension pre-bound, rung 1 (direct). These ISO3 codes are what indicator-data's `country` filter matches on, and each row
/v1/health:who/countriesParameters
| Name | Type | In | Description |
|---|---|---|---|
| region | string | query | WHO region code to restrict the countries to. |
Example response
{"project":"health:who", "data": {"count":10, "items": [ {"code":"BGD","name":"Bangladesh","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"BTN","name":"Bhutan","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"IND","name":"India","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"LKA","name":"Sri Lanka","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"MDV","name":"Maldives","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"MMR","name":"Myanmar","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"NPL","name":"Nepal","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"PRK","name":"Democratic People's Republic of Korea","regionCode":"SEAR","regionName":"South-East Asia" } ],"region":"SEAR","provider":"who" },"timestamp":"2026-08-30T00:49:29Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Dimension Values
WHO Global Health Observatory — valid values for one dimension, rung 1 (direct). An unknown dimension answers 200 with an empty `value[]` rather than a 404, so the empty
/v1/health:who/dimension-values/:dimensionParameters
| Name | Type | In | Description |
|---|---|---|---|
| dimension | string | path | Dimension code from the dimensions endpoint. Required. |
Example response
{"project":"health:who", "data": {"count":234, "items": [ {"code":"ABW","title":"Aruba","dimension":"COUNTRY","parentCode":"AMR","parentTitle":"Americas","parentDimension":"REGION" }, {"code":"AFG","title":"Afghanistan","dimension":"COUNTRY","parentCode":"EMR","parentTitle":"Eastern Mediterranean","parentDimension":"REGION" }, {"code":"AGO","title":"Angola","dimension":"COUNTRY","parentCode":"AFR","parentTitle":"Africa","parentDimension":"REGION" }, {"code":"AIA","title":"Anguilla","dimension":"COUNTRY","parentCode":"AMR","parentTitle":"Americas","parentDimension":"REGION" }, {"code":"ALB","title":"Albania","dimension":"COUNTRY","parentCode":"EUR","parentTitle":"Europe","parentDimension":"REGION" }, {"code":"AND","title":"Andorra","dimension":"COUNTRY","parentCode":"EUR","parentTitle":"Europe","parentDimension":"REGION" }, {"code":"ARE","title":"United Arab Emirates","dimension":"COUNTRY","parentCode":"EMR","parentTitle":"Eastern Mediterranean","parentDimension":"REGION" }, {"code":"ARG","title":"Argentina","dimension":"COUNTRY","parentCode":"AMR","parentTitle":"Americas","parentDimension":"REGION" } ],"provider":"who","dimension":"COUNTRY" },"timestamp":"2026-08-30T00:49:29Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Dimensions
WHO Global Health Observatory — the dimension catalogue, rung 1 (direct). The vocabulary behind every filterable field on indicator-data; the collection has no
/v1/health:who/dimensionsParameters
No parameters. Call it as is.
Example response
{"project":"health:who", "data": {"count":202, "items": [ {"code":"ADVERTISINGTYPE","title":"SUBSTANCE_ABUSE_ADVERTISING_TYPES" }, {"code":"AGEGROUP","title":"Age Group" }, {"code":"ALCOHOLTYPE","title":"Beverage Types" }, {"code":"AMRGLASSCATEGORY","title":"AMR GLASS Category" }, {"code":"ANTIBIOTIC","title":"Antibiotic" }, {"code":"ARCHIVE","title":"Archive date" }, {"code":"ASSISTIVETECHBARRIER","title":"Barriers to accessing assistive products" }, {"code":"ASSISTIVETECHFUNDING","title":"Funding for assistive tech products" } ],"provider":"who" },"timestamp":"2026-08-30T00:49:29Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Indicator Data
WHO Global Health Observatory — observations for one indicator, rung 1 (direct). Every indicator code is its own OData collection, so the code goes in the path and an unknown
/v1/health:who/indicator-data/:indicatorParameters
| Name | Type | In | Description |
|---|---|---|---|
| indicator | string | path | Indicator code from the indicators endpoint. Required. |
| country | string | query | ISO3 country code to restrict the rows to. |
| region | string | query | WHO region code of the parent location. |
| spatialDimType | enum | query | Level the rows are reported at. One of COUNTRY, REGION, WORLDBANKINCOMEGROUP. |
| year | number | query | Single reporting year. |
| yearFrom | number | query | Earliest reporting year. |
| yearTo | number | query | Latest reporting year. |
| dim1 | string | query | First disaggregation code, commonly sex. |
| dim2 | string | query | Second disaggregation code. |
| dim3 | string | query | Third disaggregation code. |
| orderBy | enum | query | Sort field. Default year. One of year, value, country, id. |
| order | enum | query | Sort direction. Default desc. One of asc, desc. |
| page | number | query | Page number. Default 1. |
| limit | number | query | Items per page. Default 20, max 200. |
Example response
{"project":"health:who", "data": {"page":1,"count":0,"items":[],"limit":3,"total":0,"hasMore":false,"nextPage":null,"provider":"who","indicator":"WHOSIS_000001" },"timestamp":"2026-08-30T00:49:29Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Indicators
WHO Global Health Observatory — the indicator catalogue (3,095 rows), rung 1 (direct). OData v4 over an Azure CDN edge, no key. $filter is built here from named parameters only:
/v1/health:who/indicatorsParameters
| Name | Type | In | Description |
|---|---|---|---|
| search | string | query | Substring matched against the indicator name. |
| code | string | query | Exact indicator code. |
| page | number | query | Page number. Default 1. |
| limit | number | query | Items per page. Default 20, max 200. |
Example response
{"project":"health:who", "data": {"code":"WHOSIS_000001","page":1,"count":0,"items":[],"limit":3,"total":0,"search":"malaria","hasMore":false,"nextPage":null,"provider":"who" },"timestamp":"2026-08-30T00:49:29Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Regions
WHO Global Health Observatory — the REGION dimension pre-bound, rung 1 (direct). Region rows are top-level, so ParentCode/ParentTitle arrive null here rather than absent.
/v1/health:who/regionsParameters
No parameters. Call it as is.
Example response
{"project":"health:who", "data": {"count":43, "items": [ {"code":"AFR","name":"Africa","dimension":"REGION","parentCode":null,"parentName":null }, {"code":"AMR","name":"Americas","dimension":"REGION","parentCode":null,"parentName":null }, {"code":"EMR","name":"Eastern Mediterranean","dimension":"REGION","parentCode":null,"parentName":null }, {"code":"EUR","name":"Europe","dimension":"REGION","parentCode":null,"parentName":null }, {"code":"GBD_REG14_AFRD","name":"Africa region, stratum D (AFR D)","dimension":"REGION","parentCode":null,"parentName":null }, {"code":"GBD_REG14_AFRE","name":"Africa region, stratum E(AFR E)","dimension":"REGION","parentCode":null,"parentName":null }, {"code":"GBD_REG14_AMRA","name":"Americas region, stratum A (AMR A)","dimension":"REGION","parentCode":null,"parentName":null }, {"code":"GBD_REG14_AMRB","name":"Americas region, stratum B (AMR B)","dimension":"REGION","parentCode":null,"parentName":null } ],"provider":"who" },"timestamp":"2026-08-30T00:49:29Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Try it
Live request with your key
const data = await client.run( "health:who", "countries", { region: "SEAR" });
WHO GHO
World Health Organization Global Health Observatory — 3,095 indicators with country, region, year and disaggregation filters plus uncertainty intervals.
WHO Global Health Observatory — the COUNTRY dimension pre-bound, rung 1 (direct). These ISO3 codes are what indicator-data's `country` filter matches on, and each row
/v1/…who/countriesTry it
Parameters
region
string · query · optional
WHO region code to restrict the countries to.
Example response
{"project":"health:who", "data": {"count":10, "items": [ {"code":"BGD","name":"Bangladesh","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"BTN","name":"Bhutan","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"IND","name":"India","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"LKA","name":"Sri Lanka","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"MDV","name":"Maldives","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"MMR","name":"Myanmar","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"NPL","name":"Nepal","regionCode":"SEAR","regionName":"South-East Asia" }, {"code":"PRK","name":"Democratic People's Republic of Korea","regionCode":"SEAR","regionName":"South-East Asia" } ],"region":"SEAR","provider":"who" },"timestamp":"2026-08-30T00:49:29Z"}
Errors
- 401Missing or invalid x-api-key
- 404Not found or private
- 429Rate limit or monthly quota reached
Code
const data = await client.run( "health:who", "countries", { region: "SEAR" });