ICD-10 API

ICD-10 API

The ICD-10 API is a lightweight web service which validates ICD-10 coding.
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 2022 (updated 2/01/2022)

Coming Soon: ICD-11 API

Usage

Send all requests to:

http://www.icd10api.com/?

Parameters

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.

Examples

Code Lookup
  

Request:

Response:


                

                

            

        

        

            

                

                

                    Code Search
                        

                            
                            

                                
                            

                        

                        

                            
                            

                                
                            

                        

                        

                            
                            

                                
                            

                        

                        

                            

                                  
                                
                            

                        

                

                

                    

                    
Request:

                    

                

                

                    

                    

                

                

                    
Response:

                    

                

                

            

        

    









Fields




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).















Change Log