Map ICD-10 to ICD-11
map_icd10_to_icd11Maps ICD-10 codes to WHO-authoritative ICD-11 categories, returning primary and alternative mappings with titles and URIs for clinical coding, billing migration, and retrospective analysis.
Instructions
Authoritative ICD-10 → ICD-11 mapping using WHO transition tables (release 2025-01, bundled with the server).
Returns the primary 1:1 ICD-11 category for the ICD-10 code plus any alternative ICD-11 candidates that WHO documents (some ICD-10 concepts split into multiple ICD-11 entities). For each mapping, includes the ICD-11 code, title, chapter, and the Foundation URI / Linearization URI for navigating to the full entity definition.
Use this for clinical coding, billing migration, retrospective analysis, and any workflow that needs authoritative mapping rather than text-search candidates. Coverage: 11,243 ICD-10 categories (excludes chapters and blocks like "A00-A09" which aren't used in clinical coding).
Provide a code like "E11" (Type 2 diabetes), "I21" (Acute MI), or "A07.8" (4 alternatives in WHO's table). Both dotted ("A07.8") and undotted ("A078") forms are accepted.
Returns "no mapping" when the code isn't in the WHO category-level table — that's the honest answer rather than a fuzzy search fallback.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| icd10_code | Yes | ICD-10 code to query in the ICD-11 search index (e.g., E11, I21.0, J18.9) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| found | Yes | Whether the code is in the WHO ICD-10 → ICD-11 transition table. | |
| icd10 | Yes | Source ICD-10 entry from the WHO table. Null when found=false. | |
| query | Yes | The ICD-10 code as submitted (raw, before normalization). | |
| source | Yes | ||
| primary | Yes | Primary 1:1 ICD-11 mapping. Null when found=false. | |
| provenance | Yes | Provenance block (contract v1.0): source, URL, data vintage, extraction instant, citation, license | |
| attribution | Yes | Canonical source URLs of this response (attribution list) | |
| alternatives | Yes | Additional ICD-11 candidates WHO documents for this ICD-10 code. Empty when the primary is the only documented mapping (or when found=false). 1,461 of the 11,243 indexed codes have non-empty alternatives. |