ICD-11

GET/v0/icd11

Validates an ICD-11 MMS stem code (WHO, 11th revision — Mortality and Morbidity Statistics linearization). Codes start with a digit 1–9 (chapter) followed by alphanumeric characters — letters I and O are excluded to avoid confusion with digits 1 and 0. Examples: 1A00, CA40.0.

Guides: Node.js · Python

Try it

Query Parameters

Parameter	Type	Required	Description
value	string	Yes	ICD-11 MMS stem code to validate.

Example Requests

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/icd11?value=1A00"

Response Fields

Field	Type	Description
valid	boolean	Whether the code has valid ICD-11 format
found	boolean	Whether the code exists in the WHO MMS dictionary
icd11	string	Normalised input code
title	string \| null	Entity title
chapter	string \| null	Chapter number
isLeaf	boolean \| null	True if the code has no child entities
foundationUri	string \| null	WHO foundation URI for the entity
version	string \| null	MMS release version

Example Response

{
  "valid": true,
  "found": true,
  "icd11": "1A00",
  "title": "Cholera",
  "chapter": "01",
  "parent": null,
  "isLeaf": false,
  "foundationUri": "http://id.who.int/icd/entity/257068234",
  "blockId": null,
  "version": "MMS"
}

Example Response — invalid

{
  "valid": false
}

ICD-11 data sourced from the WHO ICD-API (Mortality and Morbidity Statistics linearization). ICD is © World Health Organization — reused under the CC BY-ND 3.0 IGO licence.