Open data & API

The code tables as files, and a JSON endpoint per code

Everything on this page is public-domain government reference data, cut from the exact CMS and CDC release loaded on this site and regenerated with every deploy. No sign-up, no key, no rate card. Use it in a spreadsheet, a script, an EHR integration or a classroom. If you publish something built on it, a link back is appreciated and is what keeps the files funded.

Files last generated September 15, 2026. Checksums are in /data/manifest.json.

Downloads

CSV files are UTF-8 with a header row and CRLF line endings, so Excel opens them directly. Multi-value fields are joined with a vertical bar. JSON files are arrays of objects with the same column names.

ICD-10-CM diagnosis codes

98,186 rows · FY2026-Apr

Every ICD-10-CM code in the current CMS/CDC release with its description, hierarchy level, billable flag, parent code, chapter, block and POA-exempt status. Categories and subcategories are included so the file reconstructs the full tree; chapter and block titles are in the structure files.

icd-10-cm-codes.csv11.4 MB

Columns: code, description, level, billable, parent_code, chapter_code, block_code, poa_exempt
Source: CMS / CDC-NCHS ICD-10-CM tabular list, effective April 1, 2026
Licence: Public domain (US Government work); no restrictions.

ICD-10-CM chapters and blocks

319 rows · FY2026-Apr

The 22 chapters and every code block (three-character range) of ICD-10-CM, in official order. Join to the code file on chapter_code and block_code.

Columns: code, title, chapter_code, code_range, sort_order
Source: CMS / CDC-NCHS ICD-10-CM tabular list, effective April 1, 2026
Licence: Public domain (US Government work); no restrictions.

ICD-10-PCS procedure codes

80,029 rows · FY2026

Every ICD-10-PCS inpatient procedure code in the current CMS release, with short and long descriptions and the section it belongs to, in CMS order.

icd-10-pcs-codes.csv11.8 MB

Columns: code, billable, short_desc, long_desc, section
Source: CMS ICD-10-PCS order file, effective October 1, 2025
Licence: Public domain (US Government work); no restrictions.

HCPCS Level II codes

8,725 rows · 2026Q3-Jul

The CMS HCPCS Level II file, with the multi-record long descriptions reassembled into one field per code, plus pricing indicator, Medicare coverage code, BETOS category and add/termination dates. Dental (D) codes are not present: CDT is ADA-licensed and CMS strips it from the public file.

Columns: code, short_desc, long_desc, pricing_indicator, coverage_code, betos, add_date, term_date
Source: CMS HCPCS quarterly update, effective July 1, 2026
Licence: Public domain (US Government work); no restrictions.

MS-DRG list with relative weights

772 rows · FY2026

Every MS-DRG in the current IPPS final rule: number, MDC, medical/surgical type, title, post-acute and special-pay flags, relative weight (before and after the cap), and geometric and arithmetic mean length of stay.

Columns: drg, mdc, drg_type, title, post_acute, special_pay, weight_before_cap, weight_capped, geometric_mean_los, arithmetic_mean_los
Source: CMS IPPS final rule, Table 5, effective October 1, 2025
Licence: Public domain (US Government work); no restrictions.

Healthcare Provider Taxonomy codes

883 rows · 25.1

The NUCC Health Care Provider Taxonomy code set: every code with its grouping, classification, specialization, definition and display name.

Columns: code, grouping, classification, specialization, definition, notes, display_name, section
Source: National Uniform Claim Committee (NUCC), effective July 1, 2025
Licence: Published by NUCC for free public use; see nucc.org for its terms.

Denial codes: causes, fixes and prevention

44 rows

Our own plain-English guide to the CARC and RARC denial codes billers see most: what actually triggers each one, how to resolve the denial in hand, and how to stop the next one. Written from practice, not copied from X12 — the official X12 wording is not included and is linked from each page instead.

Columns: code, group, summary, causes, fix, prevent, scrubbable, appealable, related, url
Source: MedicalCodingSoftware.org editorial
Licence: CC BY 4.0 — attribution to MedicalCodingSoftware.org with a link.

JSON endpoints

One code per request, read-only, CORS-open, cached at the edge for a day. Requests are plain GETs with no authentication. A missing code returns 404 with a JSON body. The limit is 300 requests per minute per address, which no interactive client will reach; for bulk work use the files above.

GET /data/v1/icd-10-cm/{code}

Accepts E11.9, e11-9 or the dotless E119. Returns description, level, billable flag, parent, chapter, block, POA-exempt status, seventh-character rule and the tabular notes (Excludes1/2, code first, use additional, code also).

Try it: medicalcodingsoftware.org/data/v1/icd-10-cm/E11.9

GET /data/v1/hcpcs/{code}

Long and short descriptions, pricing indicator, Medicare coverage code, BETOS, add/termination dates, and the Physician Fee Schedule RVUs where a national row exists.

Try it: medicalcodingsoftware.org/data/v1/hcpcs/J1885

GET /data/v1/ms-drg/{drg}

Title, MDC, medical/surgical type, relative weight, geometric and arithmetic mean length of stay, and the IPPS release the row came from.

Try it: medicalcodingsoftware.org/data/v1/ms-drg/871

{
  "code": "E11.9",
  "code_dotless": "E119",
  "description": "Type 2 diabetes mellitus without complications",
  "level": "code",
  "billable": true,
  "parent_code": "E11",
  "chapter": { "code": "4", "title": "Endocrine, nutritional and metabolic diseases" },
  "block": { "code": "E08-E13", "title": "Diabetes mellitus" },
  "poa_exempt": false,
  "notes": { "useAdditional": ["..."], "excludes1": ["..."] },
  "url": "https://medicalcodingsoftware.org/icd-10-cm/e11-9"
}

Licence and attribution

ICD-10-CM, ICD-10-PCS, HCPCS Level II and MS-DRG are works of the United States Government and are in the public domain. The provider taxonomy is published by the National Uniform Claim Committee for free public use. Nothing in these files is licensed from a private code owner: there is no CPT (American Medical Association), no CDT (American Dental Association), and no X12 CARC/RARC wording.

The denial-code table is our own writing and is released under CC BY 4.0: use it freely with attribution to MedicalCodingSoftware.org and a link to the relevant page.

Suggested citation: MedicalCodingSoftware.org. Open data: ICD-10-CM, HCPCS Level II and MS-DRG tables. https://medicalcodingsoftware.org/developers. Accessed [date].

Update cadence and provenance

The files are cut from the same database that renders every page on this site, so they can never lag the site itself. The release each dataset came from, its government source and its update schedule are documented on the data sources page. Found an error? Use the corrections process; a fix lands in the files on the next deploy.