Skip to main content
Python
import requests

url = 'https://api.simplex.sh/pa_search_icd_codes'
headers = {
    'X-API-Key': 'your_api_key_here'
}
params = {
    'credential_name': 'my_availity_creds',
    '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>"
    }
  ]
}
ICD-10 codes describe the reason for the procedure — for example, M17.11 is “Primary osteoarthritis, right knee”. The code returned here is the exact value required by Submit Prior Auth.

Authorizations

X-API-Key
string
header
required

Simplex API Key

Query Parameters

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

200 - application/json

Search ICD codes response

succeeded
boolean
required

Whether the search was successful.

diagnoses
object[]
required

List of matching diagnoses.