ICD-10-CM code search by term API

Fuzzy free-text search of the ICD-10-CM diagnosis code set (NLM Clinical Tables), normalized with a derived billable-leaf flag and chapter letter. Answers 'What ICD-10 code is type 2 diabetes?', 'Find diagnosis codes for asthma'.

Price$0.01per request

MethodPOST

Route/v1/health/clinical-icd10-search

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache604800s public

healthclinicalicd10icd-10-cmdiagnosismedical-codingterminologynlm

API URLhttps://x402.hexl.dev/v1/health/clinical-icd10-search

Integration docs

Example request

{
  "term": "type 2 diabetes",
  "max": 3
}

Example response

{
  "query": "type 2 diabetes",
  "totalMatches": 94,
  "returned": 3,
  "results": [
    {
      "code": "E11.65",
      "name": "Type 2 diabetes mellitus with hyperglycemia",
      "billable": true,
      "chapter": "E"
    },
    {
      "code": "E11.9",
      "name": "Type 2 diabetes mellitus without complications",
      "billable": true,
      "chapter": "E"
    },
    {
      "code": "E10.A2",
      "name": "Type 1 diabetes mellitus, presymptomatic, Stage 2",
      "billable": true,
      "chapter": "E"
    }
  ],
  "codingSystem": "ICD-10-CM",
  "disclaimer": "Informational reference/terminology data only — NOT medical advice. Verify against authoritative sources and a qualified professional before any clinical, billing, or treatment decision."
}

Input schema

{
  "type": "object",
  "required": [
    "term"
  ],
  "properties": {
    "term": {
      "type": "string",
      "description": "Free-text diagnosis term"
    },
    "max": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}