ICD-11 Code Reference

What this Actor does

Lookup, search, and translate WHO ICD-11 disease codes through the official WHO ICD-11 API. Writes one normalized ICD-11 entity per input to the Apify dataset.

Input example

{
  "mode": "search",
  "query": "type 2 diabetes",
  "code": "5A11",
  "linearization": "mms",
  "language": "en"
}

Input fields

Provide an operating mode plus a query, an ICD-11 code, or an ICD-10 code. The Actor calls the WHO ICD-11 API and writes one response per input.

• mode (string, user input): Which WHO ICD-11 operation to run. 'search' performs a flexible search by query, 'lookup' fetches an entity by ICD-11 code, and 'icd10-to-icd11' translates an ICD-10 code via the WHO codeinfo endpoint.
• query (string, user input): Free-text disease, symptom, or condition for mode=search (e.g. 'type 2 diabetes', 'asthma').
• code (string, user input): ICD-11 code for mode=lookup or ICD-10 code for mode=icd10-to-icd11.
• linearization (string, user input): WHO ICD-11 linearization. 'mms' is the Mortality and Morbidity Statistics linearization, 'icf' is the International Classification of Functioning.
• language (string, user input): Two-letter language code sent as Accept-Language header (e.g. en, fr, es, ar, zh).
• clientId (string, user input): OAuth2 client ID issued at https://icd.who.int. Stored as an Apify secret.
• clientSecret (string, user input): OAuth2 client secret issued at https://icd.who.int. Stored as an Apify secret.

Output dataset

Each successful upstream response is written to the default dataset.

• input: Original input value submitted to the upstream API.
• result: Full upstream API response.

Developer notes

Set ICD_11_CODE_REFERENCE_API_KEY as an Apify secret environment variable. The Actor forwards it as X-API-Key to the upstream API. Use apiBaseUrl only for local or staging QA. Production runs default to the deployed API base URL from service.json. For advanced testing, a requests array can call explicit API paths; normal users should use the service-specific fields above.

Run locally

$apify run

Deploy

$apify push