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 exampleABORTION_ADMISSIONSIndicatorName, the full description, for example “Abortion admissions per 1000 women of reproductive age”Language, the language code of the name, for exampleEN
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=nreturns 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=jsonis 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.
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.
- Nigeria Demographic and Health Survey 2021 – Key Indicators
- UNICEF Ethiopia Multiple Indicator Cluster Survey 2016 (MICS 2016)
Most downloaded in the library
Every document listed here is hosted on this site and downloads immediately.
