Healthcare Code Search API (2.13.7)

Download OpenAPI specification:

E-mail: codesearch@datainsight.health URL: https://datainsight.health/products/code-search-api-signup/

Healthcare Code Lookup

Searches healthcare codes sets, such as ICD-10, HCPCS, NDC and many others and returns JSON or CSV with codes and descriptions.

Request you API key here.

User Guide
Examples in our GitHub repo

Code details

Fetches code's details, including the code's edits and categories

Authorizations:

ApiKeyAuth

path Parameters

code

required

string

query Parameters

type	string Example: type=PROCEDURE Has to be supplied if the code may not be unique across all code sets. E.g., some codes could be used for both procedure and diagnosis

Responses

Response samples

Content type

application/json

{"type": "PROCEDURE",
"subType": "CPT",
"code": "36425",
"desc": "Venipuncture, cutdown; age 1 or over",
"fullDesc": "Venipuncture, cutdown; age 1 or over",
"shortDesc": "VENIPUNCTURE CUTDOWN 1 YR/>",
"startDate": "1993-01-01",
"categories": [{"type": "RBCS_TAXONOMY",
"subType": "RBCS_CATEGORY",
"code": "P",
"desc": "Procedure"
},
{"type": "RBCS_TAXONOMY",
"subType": "RBCS_SUB_CATEGORY",
"code": "PV",
"desc": "Vascular"
}
],
"edits": {"mueLimits": [{"claimType": "HOSPITAL",
"maxUnits": 2,
"rationale": "Clinical: CMS Workgroup"
},
{"claimType": "PRACTITIONER",
"maxUnits": 2,
"rationale": "Clinical: CMS Workgroup"
}
],
"minAge": 1,
"maxAge": 124,
"checkTypes": ["MUE",
"MIN_AGE",
"MAX_AGE",
"PTP"
],
"disallowedCodes": [{"code": "0543T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0544T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0545T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0548T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0553T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0563T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0565T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0566T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0567T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0568T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0569T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0570T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0571T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0572T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0573T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0574T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0580T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0581T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0582T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "0655T",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "15772",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "15774",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "20560",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "20561",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "20700",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "20701",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "20702",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "20703",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "20704",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "20705",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "21602",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "21603",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "33017",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "33018",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "33019",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "33858",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "33859",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "33871",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "34717",
"rationale": "CPT Manual or CMS manual coding instructions",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "34718",
"rationale": "CPT Manual or CMS manual coding instructions",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "35702",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "35703",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "36410",
"rationale": "CPT \"separate procedure\" definition",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "36420",
"rationale": "Mutually exclusive procedures",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "37202",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "49013",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "49014",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["HOSPITAL"
],
"modifierAllowed": true
},
{"code": "62318",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "62319",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "64415",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "64416",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "64417",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "64450",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "64470",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "64475",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "64490",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "64493",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "66987",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "66988",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "69990",
"rationale": "Misuse of column two code with column one code",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": false
},
{"code": "90772",
"rationale": "Standards of medical / surgical practice",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "90774",
"rationale": "Standards of medical / surgical practice",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "90775",
"rationale": "Standards of medical / surgical practice",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "96372",
"rationale": "Standards of medical / surgical practice",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "96374",
"rationale": "Standards of medical / surgical practice",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "96375",
"rationale": "Standards of medical / surgical practice",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "96376",
"rationale": "Standards of medical / surgical practice",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "C8952",
"rationale": "Standards of medical / surgical practice",
"claimTypes": ["PRACTITIONER",
"HOSPITAL"
],
"modifierAllowed": true
},
{"code": "36591",
"rationale": "CPT Manual or CMS manual coding instructions",
"claimTypes": ["PRACTITIONER"
],
"modifierAllowed": false
},
{"code": "36592",
"rationale": "CPT Manual or CMS manual coding instructions",
"claimTypes": ["PRACTITIONER"
],
"modifierAllowed": false
},
{"code": "96523",
"rationale": "CPT Manual or CMS manual coding instructions",
"claimTypes": ["PRACTITIONER"
],
"modifierAllowed": false
},
{"code": "G0351",
"rationale": "Standards of medical / surgical practice",
"claimTypes": ["PRACTITIONER"
],
"modifierAllowed": true
},
{"code": "G0353",
"rationale": "Standards of medical / surgical practice",
"claimTypes": ["PRACTITIONER"
],
"modifierAllowed": true
},
{"code": "G0354",
"rationale": "Standards of medical / surgical practice",
"claimTypes": ["PRACTITIONER"
],
"modifierAllowed": true
}
]
}
}

Code search

Searches healthcare code sets using provided search terms. The terms can include codes or any word from a code's description or definition

Code search user guide with examples

Authorizations:

ApiKeyAuth

query Parameters

query required	string Example: query=0080,0LRQ07Z,knee replacement Search query
type	string Example: type=diagnosis Narrow down the query to a particular code set
afterStartDate	string <date> Example: afterStartDate=2020-12-10 Find codes with the start (effective) date after the parameter's value
afterEndDate	string <date> Example: afterEndDate=2020-12-10 Find codes with the end (deactivation) date after the parameter's value

Responses

Request samples

# Simple search
curl -H "X-Api-Key: 123456" $API_URL/code/search?query=0LBQ4
# By words in the description
curl -H "X-Api-Key: 123456" -G $API_URL/code/search?type=procedure --data-urlencode 'query=endo right knee'
# Multiple codes
curl -H "X-Api-Key: 123456" -G $API_URL/code/search?type=procedure --data-urlencode 'query=0LBQ4, 0Y3F4ZZ'
# Initial code letter + description
curl -H "X-Api-Key: 123456" -G $API_URL/code/search?type=procedure --data-urlencode 'query=code:j adrenalin'

Response samples

Content type

application/json

[{"type": "DIAGNOSIS",
"subType": "ICD_10",
"code": "A049",
"desc": "Bacterial intestinal infection, unspecified",
"formattedCode": "A04.9"
},
{"type": "DRUG",
"subType": "NDC",
"code": "0002-1243",
"desc": "MOUNJARO (tirzepatide)",
"fullDesc": "MOUNJARO (tirzepatide); Form: Injection, solution; Route: Subcutaneous; Labeler: Eli Lilly and Company",
"startDate": "2023-07-28",
"endDate": "2024-12-31"
},
{"type": "PROCEDURE",
"subType": "CPT",
"code": "0001A",
"desc": "Immunization administration by intramuscular injection of severe acute respiratory syndrome coronavirus 2 (SARS-CoV-2) (coronavirus disease [COVID-19]) vaccine, mRNA-LNP, spike protein, preservative free, 30 mcg/0.3mL dosage, diluent reconstituted; first dose",
"fullDesc": "Immunization administration by intramuscular injection of severe acute respiratory syndrome coronavirus 2 (SARS-CoV-2) (coronavirus disease [COVID-19]) vaccine, mRNA-LNP, spike protein, preservative free, 30 mcg/0.3mL dosage, diluent reconstituted; first dose",
"shortDesc": "ADM SARSCOV2 30MCG/0.3ML 1ST",
"startDate": "2020-12-11",
"endDate": "2023-10-31"
}
]

Get codes as CSV

Exports codes that matched the query in the CSV format

Code search user guide with examples

Authorizations:

ApiKeyAuth

query Parameters

query	string
downloadAsFile	boolean
fileName	string
howMany	integer <int32>
type	string

Responses

Request samples

# All procedures
curl -G $API_URL/code/csv?type=procedure
# Procedures for the search query
curl -G $API_URL/code/csv?type=procedure --data-urlencode 'query=0LBQ4, 0Y3F4ZZ'