JSON Dump of ICD 10 Codes & Desc

README.md

CMS ICD GEMs JSON Dump

JSON Dump of ICD 10 Codes & Desc

Data Sample (formatted)

[
    {
      "code": "A000",
      "desc": "holera due to Vibrio cholerae 01, biovar cholerae"
    }, {
      "code": "A001",
      "desc": "holera due to Vibrio cholerae 01, biovar eltor"
    },
]

Source

Data raw text data downloaded from CMS ICD GEMs

Conversion

import json

"""Convert CMS GEM ICD Dump to ICD Code:Desc JSON dump.

    Data downloaded from: https://www.cms.gov/Medicare/Coding/ICD10/2018-ICD-10-CM-and-GEMs.html
"""

# import raw txt
path_import = r'./icd10cm_codes_2018.txt'
with open(path_import, 'r') as _f:
    raw = _f.read()
    _f.close()

# convert raw txt to json
data = []
for rcd in raw.split('\n'):
    if rcd:
        data.append({
            'code': rcd[:8].strip(),
            'desc': rcd[9:],
        })

# export converted json
path_export = './codes_icd10.json'
with open(path_export, 'w') as _f:
    json.dump(data, _f)
    _f.close()

icd10_txt_to_json.py

icd10_codes.json

Very helpful. Thank you! For others finding themselves mired in this misery please also see https://clinicaltables.nlm.nih.gov/apidoc/icd10cm/v3/doc.html, which I found before landing here. Also, the author of this gist should update the cms.gov URL up at the top to: https://www.cms.gov/medicare/coding-billing/icd-10-codes, which lists the codes for each year including 2025.