ICD-10

GET/v0/icd10

Validates an ICD-10 diagnosis code (International Classification of Diseases, 10th revision — WHO). The regex accepts both the WHO ICD-10 base form (e.g. A00,J45.0) and the US ICD-10-CM extended form with alphanumeric characters after the decimal (e.g. S06.0X1A). Dictionary lookup is backed by the NIH/NLM Clinical Tables ICD-10-CM dataset.

Guides: Node.js · Python

Try it

Query Parameters

Parameter	Type	Required	Description
value	string	Yes	ICD-10 code to validate. Accepts both dotted (`A00.0`) and flat (`A000`) forms.

Example Requests

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

Response Fields

Field	Type	Description
valid	boolean	Whether the code has valid ICD-10 format
found	boolean	Whether the code exists in the dictionary
icd10	string	Normalised input code
title	string \| null	Diagnosis description
chapter	string \| null	Chapter letter (A–Z)
parent	string \| null	Parent code in the hierarchy
isLeaf	boolean \| null	True if the code has no child codes (billable)
source	string \| null	Dataset source (e.g. `CMS`)
version	string \| null	Dataset release identifier

Example Response

{
  "valid": true,
  "found": true,
  "icd10": "A00.0",
  "title": "Cholera due to Vibrio cholerae 01, biovar cholerae",
  "chapter": "A",
  "parent": "A00",
  "isLeaf": true,
  "source": "CMS",
  "version": "NLM-2026"
}

Example Response — invalid

{
  "valid": false
}

GET/v0/icd10/children

Returns the immediate child codes of a given ICD-10 code.

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.isvalid.dev/v0/icd10/children?code=A00"

ICD data sourced from the U.S. National Library of Medicine (NLM) Clinical Tables ICD-10-CM dataset. ICD is © World Health Organization.