CMS ICD-10 Code Files

Centers for Medicare & Medicaid Services · Health

Health No Auth Free & Open Healthcare Insurance CMS Medicare ICD-10

CMS provides annual ICD-10-CM and ICD-10-PCS code files for Medicare billing. Includes tabular lists, index files, and code validity tables. Used for Medicare/Medicaid claim validation and coding compliance. Updated each October.

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET ICD-10-CM tabular list

Download the annual CMS ICD-10-CM tabular code list (updated each October)

https://www.cms.gov/medicare/coding-billing/icd-10-codes

Hover any highlighted part to learn what it does

curl -X GET "https://www.cms.gov/medicare/coding-billing/icd-10-codes"

import requests
response = requests.get(
    "https://www.cms.gov/medicare/coding-billing/icd-10-codes",
)
print(response.json())

const url = 'https://www.cms.gov/medicare/coding-billing/icd-10-codes';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://www.cms.gov/medicare/coding-billing/icd-10-codes"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://www.cms.gov/medicare/coding-billing/icd-10-codes")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://www.cms.gov/medicare/coding-billing/icd-10-codes";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

No authentication required — public CMS downloads
Browse available files at https://www.cms.gov/medicare/coding-billing/icd-10-codes
Download the annual tabular list ZIP for ICD-10-CM code descriptions
ICD-10-CM files are updated each October for the new fiscal year
For programmatic use, parse the flat text files or use NLM Clinical Tables API instead

What can you build with CMS ICD-10 Code Files?

CMS ICD-10 Code Files is a Health API. Developers commonly use health APIs for:

accessing medical reference data and drug information
building patient-facing health tracking apps
integrating with EHR and telemedicine platforms
looking up ICD codes and clinical terminology
powering wellness and fitness applications

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. CMS ICD-10 Code Files is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗