# ICD-10-CM

URL: https://docs.healthcare.dev/datasets/icd10cm

<Freshness dataset="icd10cm" />

|                 |                                                                                                                                                                                                                           |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Source          | CMS and CDC NCHS ([cms.gov](https://www.cms.gov/medicare/coding-billing/icd-10-codes))                                                                                                                                    |
| Source id       | `cms-icd10`                                                                                                                                                                                                               |
| Release cadence | Yearly (October 1), with occasional April updates                                                                                                                                                                         |
| License         | Public domain (US government work)                                                                                                                                                                                        |
| Endpoints       | [`/v1/codes/icd10cm/{code}`](/reference/codes/look-up-a-code), [search](/reference/codes/search-codes), [hierarchy](/reference/codes/code-with-ancestors-and-children), [batch](/reference/codes/look-up-up-to-100-codes) |

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

| Field                                                       | Meaning                                                        |
| ----------------------------------------------------------- | -------------------------------------------------------------- |
| `code`                                                      | The code with its dot, e.g. `E11.9`                            |
| `display`                                                   | Short description                                              |
| `description`                                               | Long description                                               |
| `billable`                                                  | `true` for codes valid on a claim, `false` for headers (`E11`) |
| `parent`                                                    | The next code up the hierarchy                                 |
| `status`, `effective_start`, `effective_end`, `replaced_by` | Lifecycle across releases                                      |

## Example

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