Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

World Health Organization (WHO) Linearization (classification endpoints) API

The Linearization (classification endpoints) API from World Health Organization (WHO) — 13 operation(s) for linearization (classification endpoints).

World Health Organization (WHO) Linearization (classification endpoints) API is one of 3 APIs that World Health Organization (WHO) publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Linearization (classification endpoints). The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and authentication docs.

This API exposes 16 operations across 13 paths, and defines 21 schemas. It is described by OpenAPI 3.0.1, at version v2.6.0.

Requests are made against the base URL https://ghoapi.azureedge.net/api.

16 operations 13 paths 21 schemas 13 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
v2.6.0
Base URL
https://ghoapi.azureedge.net/api
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

World Health Organization (WHO) Linearization (classification endpoints) API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the clientCredentials flow, exposing 1 scope. By default, every request must be authenticated.

Paths & Operations 16

Across 13 paths, the API surfaces 16 operations — 13 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Linearization (classification endpoints) 16
GET
/icd/release/11/{linearizationname}
This endpoint returns basic information on the linearization (classification) such as ICD MMS together with the list of available releases
GetReleasesForLinerization 3 params → 200401404
GET
/icd/release/11/{linearizationname}/{id}
This endpoint returns lists the URIs of the entity in the available releases
GetAvailableReleasesForLinearizationEntity 4 params → 200401404
GET
/icd/release/11/{linearizationname}/{id}/{residual}
This endpoint returns the list of the URIs of the residual entity in the available releases.
GetAvailableReleasesForLinearizationResidualEntity 5 params → 200401404
GET
/icd/release/11/{releaseId}/{linearizationname}
This endpoint returns basic information on the released linearization (such as MMS) together with the chapters in it
GetLinearization 4 params → 200401404
GET
/icd/release/11/{releaseId}/{linearizationname}/{id}
This endpoint return information on a linearization entity
GetLinearizationEntity 6 params → 200401404
GET
/icd/release/11/{releaseId}/{linearizationname}/{id}/{residual}
This endpoint return information on a residual linearization entity
GetLinearizationResidualEntity 7 params → 200401404
GET
/icd/release/11/{releaseId}/{linearizationname}/autocode
Provides the best matching classification classification entity (its code, linearization URI, foundation URI and other related information) for the provided search text. see AutoCodingSearchResult sc…
AutoCode 7 params → 200401
GET
/icd/release/11/{releaseId}/{linearizationname}/codeinfo/{code}
This endpoint allows looking up an entity from its code. For postcoordinated code combinations, it provides more information on the code combination such as which axes are used and what values do the…
GetCodeInfo 7 params → 200401404
GET
/icd/release/11/{releaseId}/{linearizationname}/describe
This endpoint provides information on a given code, uri or combination of them. For postcoordinated code combinations, it provides more information on the code combination such as which axes are used…
Describe 9 params → 200401404
GET
/icd/release/11/{releaseId}/{linearizationname}/lookup
This endpoint allows looking up a foundation entity within a linearization and returns where that entity is coded in this linearization.
Lookup 5 params → 200401404
GET
/icd/release/11/{releaseId}/{linearizationname}/search
This endpoint is for searching the linearization (such as MMS). The search can be customized using the parameters as described Search endpoint accepts both GET and POST requests. If the size of the r…
SearchLinearization 14 params → 200401
POST
/icd/release/11/{releaseId}/{linearizationname}/search
This endpoint is for searching the linearization (such as MMS). The search can be customized using the parameters as described Search endpoint accepts both GET and POST requests. If the size of the r…
SearchLinearization 14 params → 200401
GET
/icd/release/11/{releaseId}/codedit
Death certificate checking using the COEDIT integrated in Doris system (https://icd.who.int/doris) The fields provided are fields of a standard death certificate. You don't need to provide causeOfDea…
CertificateCheck 43 params → 200400401500501
POST
/icd/release/11/{releaseId}/codedit
Death certificate checking using the COEDIT integrated in Doris system (https://icd.who.int/doris) The structure of the posted death certificate could be found at https://icd.who.int/docs/doris/en/js…
CertificateCheck 3 params body → 200400401500501
GET
/icd/release/11/{releaseId}/doris
Underlying cause of death detection using the rules of the Doris system (https://icd.who.int/doris) The fields provided are fields of a standard death certificate. You don't need to provide causeOfDe…
UnderlyingCauseOfDeathDetection1 43 params → 200400401500501
POST
/icd/release/11/{releaseId}/doris
Underlying cause of death detection using the rules of the Doris system (https://icd.who.int/doris) The structure of the posted death certificate could be found at https://icd.who.int/docs/doris/en/j…
UnderlyingCauseOfDeathDetection 3 params body → 200400401500501

Schemas 21

The contract defines 21 schemas that model the data the API accepts and returns. The most detailed are CodeInfo (69 properties), LinearizationEntity (25 properties), ISimpleEntity (20 properties), TopLevelLinearization (10 properties). Each schema is shown below with its type and property counts.

LinearizationEntity
object
Class representing a linearization entity such as a category in the MMS.
25 properties
PostcoordinationSet
object
Represents a postcoordination combination. It could be a nested postcoordination where the axis value can also be a postcoordination combination
9 properties
PropertyValueTypeEnum
integer
(0) Real: An index info from a linearization entity (1) UnderShoreLine: An index entity from an entity under the shoreline (2) UnderShoreLineLogicallyDefined:…
TopLevelLinearization
object
Class representing top level for the foundation
10 properties
PostcoordinationScaleInfo
object
This class contains information on which axes allow or require postcoordination for an entity together with the valueset that could be used for the postcoordin…
4 properties
Term
object
Class representing a term with language specific label and optional cross references
4 properties
DeathCertificateCheckResult
object
Underlying cause of death response from DORIS system
3 properties
LanguageSpecificText
object
Language specific text as used in JSON-LD
2 properties
ISimpleEntity
object
SimpleEntity class represents a single ICD Entity in a search result
20 properties
ISimplePropertyValue
object
Represents PropertyValues returned in the search result
6 properties
GuessTypeEnum
integer
CodeInfo
object
This class is used when an ICD-11 linearization queried with a code or a postcoordination code cluster It provides information on the entities referred in the…
69 properties
AutoCodingSearchResult
object
Response object for autocode endpoint
9 properties
EntityTypeEnum
integer
(0) Real: real entity in the linearization / foundation (1) UnderShoreLineLogicallyDefined: Entity in the foundation that can be represented as a post-coordina…
ISearchResult
object
Represents the search result. The search result is organized by ICD entities and in each entity we provide matching property values
8 properties
GuessWord
object
Represents a keyword returned as a as a word completion suggestion or as a next word suggestion
2 properties
PostcoordinationValue
object
Represnets a set values with a specified axis. It is used to build postcoordination combinations
2 properties
UnderlyingCauseOfDeath
object
Underlying cause of death response from DORIS system
9 properties
MatchLevelEnum
integer
MultiVersion
object
Class representing available versions of a given classification or classification entity This is used when the request is made without a relase id (or minor ve…
3 properties
PostcoordinationAvailabilityEnum
integer

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

who-linearization-classification-endpoints-api-openapi.yml Raw ↑

Other APIs World Health Organization (WHO) publishes across the network.

World Health Organization (WHO) Foundation API
World Health Organization (WHO) ICD10 API