Skip to main content
Python
import requests

url = 'https://api.simplex.sh/pa_list_prior_authorizations'
headers = {
    'Authorization': 'Bearer your_api_key_here'
}
params = {
    'bin': '003858',
    'state': 'CA',
    'icd_code': 'E11.9'
}

response = requests.get(url, headers=headers, params=params)
result = response.json()
for pa in result['prior_authorizations']:
    print(f"{pa['form_uuid']} — {pa['patient_name']} — {pa['status']}")
{
  "succeeded": true,
  "prior_authorizations": [
    {
      "form_uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "patient_name": "<string>",
      "status": "SENT_TO_PLAN",
      "submitted_at": "2023-11-07T05:31:56Z",
      "icd_code": "<string>",
      "medication": "<string>",
      "payer_name": "<string>",
      "bin": "<string>",
      "pcn": "<string>",
      "group": "<string>",
      "state": "<string>",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ]
}
Search submitted prior authorizations by any combination of bin, pcn, group, icd_code, state, or patient name. All filters are optional — omit to list every PA. Filters combine with AND semantics.

Authorizations

​
X-API-Key
string
header
required

Simplex API Key

Query Parameters

​
bin
string

Filter by pharmacy BIN (e.g. "003858").

​
pcn
string

Filter by Processor Control Number (e.g. "A4").

​
group
string

Filter by insurance group number (e.g. "RXINN01").

​
icd_code
string

Filter by exact ICD-10 diagnosis code (e.g. "E11.9").

​
state
string

Filter by two-letter state code (e.g. "CA").

​
name
string

Filter by patient name (partial match, case-insensitive).

Response

200 - application/json

List prior authorizations response

​
succeeded
boolean
required

Whether the search was successful.

​
prior_authorizations
object[]
required

Matching prior authorizations.