Skip to main content
Python
import requests

url = 'https://api.simplex.sh/pa_search_icd_codes'
headers = {
    'Authorization': 'Bearer your_api_key_here'
}
params = {
    'portal': 'covermymeds',
    'query': 'type 2 diabetes'
}

response = requests.get(url, headers=headers, params=params)
result = response.json()
for dx in result['diagnoses']:
    print(f"{dx['code']}: {dx['name']}")
{
  "succeeded": true,
  "diagnoses": [
    {
      "code": "<string>",
      "name": "<string>"
    }
  ]
}
Search for ICD-10 diagnosis codes by partial name or code. Returns a list of candidate diagnoses with their exact ICD-10 codes and descriptions. Use this endpoint to resolve a fuzzy diagnosis (e.g. “type 2 diabetes”) into an exact diagnosis_code before calling Submit Prior Auth.
Both diagnosis_code and diagnosis_name from this response are required by Submit Prior Auth. You cannot submit a prior auth with a fuzzy diagnosis — you must resolve it first using this endpoint.

Authorizations

​
X-API-Key
string
header
required

Simplex API Key

Query Parameters

​
portal
enum<string>
required

The prior authorization portal to search against (e.g. "covermymeds")

Available options:
covermymeds
​
credential_name
string
required

The name of the stored credential to authenticate with the portal. Create one via the Create Credential endpoint.

​
query
string
required

Partial diagnosis name or ICD-10 code to search for (e.g. "type 2 diabetes", "E11")

Response

Search ICD codes response

​
succeeded
boolean
required

Whether the search was successful.

​
diagnoses
object[]
required

List of matching diagnoses.