Skip to main content
Python
import requests

url = 'https://api.simplex.sh/pa_search_procedure_codes'
headers = {
    'X-API-Key': 'your_api_key_here'
}
params = {
    'credential_name': 'my_availity_creds',
    'query': '27447'
}

response = requests.get(url, headers=headers, params=params)
result = response.json()
for proc in result['procedures']:
    print(f"{proc['code']}: {proc['description']} ({proc['code_type']})")
{
  "succeeded": true,
  "procedures": [
    {
      "code": "<string>",
      "description": "<string>",
      "code_type": "CPT"
    }
  ]
}
The code returned here is the exact CPT or HCPCS identifier required by Submit Prior Auth. You cannot submit a prior auth with a fuzzy procedure description — you must resolve it first using this endpoint.

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 or full CPT/HCPCS code or procedure description to search for (e.g. "27447", "knee replacement", "total arthroplasty").

​
code_type
enum<string>

Filter by code type. If omitted, both CPT and HCPCS results are returned.

Available options:
CPT,
HCPCS

Response

200 - application/json

Search procedure codes response

​
succeeded
boolean
required

Whether the search was successful.

​
procedures
object[]
required

List of matching procedures.