Glossary
OData API
OData API is a query interface built on the open OData protocol, returning JSON over REST. WHO runs 2 of them: the Global Health Observatory API covering 3,000+ indicators for 194 Member States, and a public OData relay on data.who.int fronting downloadable CSVs, including the roughly 4,700-row DEVICES-series medical device table.
What is OData API?
OData standardizes the verbs of data access - filtering, paging, selecting fields - so any client can interrogate a compliant endpoint predictably, and responses come back as JSON.
In this slice the protocol is WHO's distribution backbone. The Global Health Observatory data repository advertises '3,000+ health indicators for 194 Member States ... queryable through a public OData API', with tags including 'odata-api' and JSON listed among data formats. A second surface, who-data-portal-data-who-int, offers 'downloadable CSVs behind a public OData relay API, built on the World Health Data Hub'. Specific holdings ride the same rails: the tobacco legacy repository ships formats labeled 'JSON (OData)', and the WHO Report on the Global Tobacco Epidemic 2023 lists 'odata_api' among its formats. Licensing terms_notes state the GHO OData API 'is offered as a public query interface without a stated separate license'.
Why does OData API matter when choosing a dataset?
A public OData endpoint turns indicator retrieval into parameterized URLs instead of file hunting, which is what keeps a multi-country health dashboard refreshable.
The consequence of not checking is silent scope error. 'Queryable through a public OData API' does not mean every one of the 3,000+ GHO indicators is current, or that a given report's underlying tables are exposed at all - some WHO products list OData as 1 format among several. And because terms_notes flag no separate license for the GHO interface, redistribution rights rest on the umbrella WHO copyright position rather than an explicit open grant. Buyers should therefore confirm both the endpoint's coverage and the license footing before building scheduled pulls, or risk an automated pipeline with unclear commercial rights.
How do you evaluate OData API in a data source?
- Probe the endpoint publicly. Both WHO surfaces are described as public - the GHO query API and the data.who.int relay - so test unauthenticated calls before budgeting for keys.
- Count the indicators. GHO covers '3,000+ health indicators for 194 Member States'; hold any mirror to that floor.
- Check the response format. Tags show 'odata-api' with json in data_formats; the tobacco legacy repository ships 'JSON (OData)' specifically.
- Ask about license terms. WHO's terms_notes say the GHO OData API has 'no stated separate license' - clarify reuse rights separately from access.
- Prefer the relay for bulk CSVs. data.who.int pairs downloadable CSVs with its OData relay, useful when a job needs files rather than filtered queries.
Related terms
OData sits in a family of standardized query interfaces; these neighbors cover the adjacent protocols and licensing questions.
Frequently asked questions
Is the WHO OData API free to query?
Yes - it is described as a public query interface, though WHO's terms note there is 'no stated separate license', so reuse conditions follow WHO's general copyright position.
What can I pull through WHO's OData endpoints?
Global Health Observatory indicators for 194 Member States, CSV-backed tables via the data.who.int relay, and tobacco-series data such as the DEVICES medical equipment records.
Datasets containing this field
Datasets containing OData API
6 datasets carry odata api in the catalog. Open one, count the fields, judge for yourself.
openFDA Device Adverse Events (MAUDE) API
mdr_report_key · event_type · date_of_event …+16 more
openFDA Device Registration & Listing API Data
registration.registration_number · registration.fei_number · registration.status_code …+13 more
WHO Medical Devices – Definitions and Policy Repository
IndicatorCode · IndicatorName · SpatialDim …+6 more
AdvaMed – Medical Technology Industry Resources
Directory Name · Website Link · Additional fields on request
Data.gov – Medical Supplies Catalog Search
Every listing shows the field dictionary, sample rows, and coverage before you commit. API, files, or your warehouse. Daily, weekly, or hourly.
Get sample rows