Skip to content

WHO: Global Health Observatory API Dataset — All Indicators 2022

🏥 World Health Organization (WHO) 📅 Year: 2022 📄 Format: CSV 📦 Size: 145 MB ⬇️ Downloads: 10

The WHO Global Health Observatory (GHO) is the World Health Organization’s central repository of health statistics for its member states, and it is queryable programmatically through a public OData API that needs no key and no registration. This page is a working reference for that API.

The base endpoint

The API root is https://ghoapi.azureedge.net/api/. It speaks OData v4, so responses are JSON objects with an @odata.context field and a value array holding the records.

Listing the indicators

Every dataset in the GHO is identified by an indicator code, and the full list is one request:

https://ghoapi.azureedge.net/api/Indicator

Each record in the returned value array has three fields:

  • IndicatorCode, the identifier you use to fetch the data, for example ABORTION_ADMISSIONS
  • IndicatorName, the full description, for example “Abortion admissions per 1000 women of reproductive age”
  • Language, the language code of the name, for example EN

This is the call to start with. Searching IndicatorName in the returned list is far quicker than guessing codes.

Fetching the data for one indicator

Append the indicator code to the API root:

https://ghoapi.azureedge.net/api/<IndicatorCode>

The response is again an OData object with a value array, one record per observation, carrying the dimension values such as country, year and sex alongside the numeric and display values.

Useful OData query options

  • $top=n returns the first n records, which is the right way to inspect a shape before pulling everything
  • $filter= restricts by dimension, for example filtering to one country code or one year
  • $select= returns only the fields you need, which matters when an indicator has many observations
  • $format=json is the default; the metadata document is at /api/$metadata

Practical notes

The API returns raw observations rather than a tidy table, so the usual pattern is to pull one indicator at a time, keep the dimension columns you actually need, and join country codes to names locally. Indicator coverage varies considerably by country and year, and a missing value means the observation was not reported rather than that it was zero. For anything published as a report rather than as an indicator, the GHO web interface and WHO’s publication pages remain the source.

Common questions

Do I need an API key? No. The GHO OData API is open and requires no key or registration.

Where do I find an indicator code? From /api/Indicator, which lists every code with its full name.

What format does it return? JSON in OData v4 shape: an @odata.context string and a value array.

Is this the same as the WHO Data Hub? WHO runs more than one data service. The GHO OData API described here is the long-standing indicator API at ghoapi.azureedge.net.

Download CSV Free to download — no registration required

Get new Ethiopian clinical guidelines by email

One short message when a new national guideline, protocol or standard is added to this library. The download above stays free either way.

No spam, unsubscribe any time. Privacy policy.

Related documents

Other guidelines and protocols on the same subject.

Most downloaded in the library

Every document listed here is hosted on this site and downloads immediately.

Browse the full document library →