healthcare.dev docs

ICD-10-CM

US diagnosis codes from CMS and CDC NCHS, with billable flags, hierarchy and full history.

Version fy2027Updated 2026-10-24Fresh
SourceCMS and CDC NCHS (cms.gov)
Source idcms-icd10
Release cadenceYearly (October 1), with occasional April updates
LicensePublic domain (US government work)
Endpoints/v1/codes/icd10cm/{code}, search, hierarchy, batch

ICD-10-CM is the US clinical modification of ICD-10, used for diagnoses on claims. Codes are returned with or without the dot (E11.9 and E119 both work).

Fields

FieldMeaning
codeThe code with its dot, e.g. E11.9
displayShort description
descriptionLong description
billabletrue for codes valid on a claim, false for headers (E11)
parentThe next code up the hierarchy
status, effective_start, effective_end, replaced_byLifecycle across releases

Example

curl https://api.healthcare.dev/v1/codes/icd10cm/E11.22/hierarchy \
  -H "Authorization: Bearer $HDEV_API_KEY"

On this page