---
id: simple-icd-10-cm
version: "1.5.0"
license: unclear
license_treatment: permissive
maintenance: aging
---

# simple-icd-10-cm — A simple python library for ICD-10-CM codes

License: permissive · Maintenance: aging · Downloads: 130.1K/mo

## What it is and what it does

simple_icd_10_cm is a Python library for working with ICD-10-CM codes. It bundles the April 2026 release of the official ICD-10-CM classification and exposes query and validation functions to check code validity, retrieve descriptions and clinical notes, and navigate parent-child and ancestor-descendant relationships within the code hierarchy.

The library is designed for healthcare applications, billing systems, and clinical data processing where you need to validate codes, look up their meanings, or understand how codes relate to each other. It includes support for extended subcategories, seventh-character modifiers, and various clinical annotations like exclusion rules and code-first instructions. You can also swap in alternative ICD-10-CM releases if needed.

Use it for:

- Validate ICD-10-CM codes in a medical billing or claims processing system before submission
- Retrieve the official description and clinical notes for a code to display in a patient record interface
- Navigate the code hierarchy to find parent categories or related codes for clinical decision support
- Check whether a code requires a seventh-character modifier and retrieve the valid options
- Build a code search or autocomplete feature that understands code relationships and exclusion rules

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python functions to validate, navigate, and retrieve metadata for ICD-10-CM medical codes, including hierarchical relationships and clinical annotations.

Yes, if you work with ICD-10-CM codes in Python. The library has no external dependencies, low install friction, a permissive license, and a stable API. Maintenance is aging but not abandoned; the last release was recent and the repository is active. No known vulnerabilities. The main caveat is confirming that the April 2026 release meets your jurisdiction's coding requirements.

## Install

pip install simple-icd-10-cm
uv add simple-icd-10-cm
poetry add simple-icd-10-cm

## Installing simple-icd-10-cm

Before you install: Low install friction with no runtime dependencies. Maintenance status is aging—last commit was 193 days ago—but the repository remains active and not archived, with a recent release in February 2026.

License in practice: Licensed under MIT (permissive), allowing free use, modification, and distribution with minimal restrictions.

Quickstart:

pip install simple-icd-10-cm

import simple_icd_10_cm as icd

# Validate a code
if icd.is_valid_item('A00.0'):
    print(icd.get_description('A00.0'))

Requires Python 3.9 or later.

Verify before relying:

- Whether the April 2026 ICD-10-CM release data is current for your jurisdiction's coding requirements
- Performance characteristics when querying large numbers of codes or traversing deep hierarchies

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 130.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ICD-10-CM code lookup, medical code validation, ICD-10-CM hierarchy navigation, clinical code metadata, ICD-10-CM code relationships, medical-coding, healthcare-data

[View on SkillFed](https://skillfed.io/packages/simple-icd-10-cm) · [View on PyPI](https://pypi.org/project/simple-icd-10-cm/)