One call. Five coding systems. Every direction we have data for.
The /v1/translate endpoint maps a code in one healthcare coding system to equivalents in every other system reachable from it: ICD-10-CM, ICD-11 MMS, SNOMED CT, UMLS, and ICF. Backed by the CMS-published crosswalks and WHO ICF Core Sets.
Supported mappings
Targets that are not reachable from the source are returned in unsupported_targets rather than as errors, so clients can pass a wide to[] array and just use whatever comes back.
| From | To | Source |
|---|---|---|
| ICD-10-CM | ICD-11 MMS | CMS-published crosswalk with mapping_type |
| ICD-10-CM | SNOMED CT | Code-level SNOMED concept IDs |
| ICD-10-CM | UMLS | Code-level UMLS CUIs |
| ICD-10-CM | ICF | WHO ICF Core Sets |
| ICD-11 MMS | ICD-10-CM | Reverse CMS-published crosswalk |
| ICF | ICD-10-CM | Reverse WHO ICF Core Set index |
Reverse mappings from SNOMED or UMLS to ICD-10 are coming in a later release once we ship the reverse concept index.
Request and response
One ICD-10 code translates into every reachable system in a single call. Omit the to field to get all of them; pass an array to narrow.
Request
POST /api/v1/translate
Authorization: Bearer sk_your_api_key
Content-Type: application/json
{
"from": { "code": "E11.9", "system": "icd10" }
}Response
{
"from": {
"code": "E11.9",
"system": "icd10",
"description": "Type 2 diabetes mellitus without complications"
},
"mappings": {
"icd11": [
{ "code": "5A11", "description": "Type 2 diabetes mellitus", "mapping_type": "equivalent" }
],
"snomed": [
{ "code": "44054006" }, { "code": "73211009" }
],
"umls": [
{ "code": "C0011860" }
],
"icf": [
{ "code": "b540", "description": "General metabolic functions", "component": "b" },
{ "code": "b5400", "description": "Basal metabolic rate", "component": "b" }
]
},
"unsupported_targets": [],
"provider": "autoicd-translate-v0.1"
}Targeted request
POST /api/v1/translate
{
"from": { "code": "I50.9", "system": "icd10" },
"to": ["icd11", "snomed"]
}Built on canonical sources
- CMS GEMs / Final Rule crosswalks for the ICD-10 ↔ ICD-11 direction with
mapping_typemetadata (equivalent, narrower, broader, related). - SNOMED CT / UMLS concept IDs joined at the ICD-10 code level from the same enriched refset used by our coding engine.
- WHO ICF Core Sets for bidirectional ICD-10 ↔ ICF mapping, with ICF component letters (b/s/d/e) preserved on each target.
Translate codes from your stack in one call
Same API key you use for coding and audit. Get started in under a minute.