This tool is based on the General Equivalency Mapping (GEM) files published by CMS, and is not intended to be used as an ICD-10 conversion, or ICD-9 to ICD-10 crosswalk tool. Keep in mind that while many codes in ICD-9-CM map directly to codes in ICD-10, in some cases, a clinical analysis may be required to determine which code or codes should be selected for your mapping. Always review mapping results before applying them.

Supported formats

  • JSON
  • JSONP
  • XML

Limit

You are limited to 2500 requests per day (30 requests per minute). If you need more, please contact me for an unrestricted API key.

Contact

Version

ICD-10-CM/PCS 2018 (updated 6/11/2018)

Coming Soon: ICD-11 API

Send all requests to:

http://www.icd10api.com/?

Code Lookup

Parameter Required Valid options Default Value Description
code Yes <none> The code you want to validate (e.g. A00.1, W59.21XS)
r No json, xml json The data type you wish the API to return.
desc No long, short short Use long or short ICD descriptions.
type No cm, pcs <none> The type of ICD-10 code to return.
callback No <none> JSONP callback name.

Code Search New!

Parameter Required Valid options Default Value Description
s Yes <none> The code(s) you want to search for (e.g. A00.1, W59.21XS)
page No 1-100 1 Page number to return.
r No json, xml json The data type you wish the API to return.
desc No long, short short Use long or short ICD descriptions.
type Yes cm, pcs <none> The type of ICD-10 code to return.
callback No <none> JSONP callback name.
Code Lookup
  

Request:

Response:


                
Code Search
  

Request:

Response:


                

When validating codes

Field Type Description
Name String The ICD code validated.
Description String The ICD code description.
Valid Int If the ICD code is vaild:
1 - code is valid for submission for HIPAA-covered transactions.
0 - code is a “header” not valid for HIPAA-covered transactions.
Inclusions List These terms may be synonyms or various other conditions that are assigned to the code. Inclusion terms do not necessarily constitute a comprehensive list.
excludesOne List A type 1 excludes note is a pure excludes. It means "not coded here". A type 1 excludes note indicates that the code excluded should never be used at the same time as the code above. A type 1 excludes note is for used for when two conditions cannot occur together, such as a congenital form versus an acquired form of the same condition.
excludesTwo List A type 2 excludes note represents "not included here". A type 2 excludes note indicates that the condition excluded is not part of the condition it is excluded from but a patient may have both conditions at the same time. When a type 2 excludes note appears under a code it is acceptable to use both the code and the excluded code together.
Type String The type of ICD code returned. (e.g. ICD-10-CM, ICD-10-PCS)
Response Boolean Response from API.
Error String Error message (only if Response is False).