AutoICD API

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.

FromToSource
ICD-10-CMICD-11 MMSCMS-published crosswalk with mapping_type
ICD-10-CMSNOMED CTCode-level SNOMED concept IDs
ICD-10-CMUMLSCode-level UMLS CUIs
ICD-10-CMICFWHO ICF Core Sets
ICD-11 MMSICD-10-CMReverse CMS-published crosswalk
ICFICD-10-CMReverse 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_type metadata (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.