Skip to main content
Python
import requests

url = 'https://api.simplex.sh/pa_search_drugs'
headers = {
    'Authorization': 'Bearer your_api_key_here'
}
params = {
    'portal': 'covermymeds',
    'query': 'ozempic'
}

response = requests.get(url, headers=headers, params=params)
result = response.json()
for drug in result['drugs']:
    print(f"{drug['drug_id']}: {drug['full_name']} ({drug['strength']}, {drug['dosage_form_name']})")
{
  "succeeded": true,
  "drugs": [
    {
      "drug_id": "<string>",
      "full_name": "<string>",
      "strength": "<string>",
      "dosage_form_name": "<string>",
      "route": "<string>"
    }
  ]
}
Search for drugs by partial name match. Returns a list of candidate drugs with their exact DDIDs, strengths, dosage forms, and routes. Use this endpoint to resolve a fuzzy drug name (e.g. “ozempic 1mg”) into an exact drug_id before calling Submit Prior Auth.
The drug_id (DDID) returned here is the exact identifier required by Submit Prior Auth. You cannot submit a prior auth with a fuzzy drug name — 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 or full drug name to search for (e.g. "ozempic", "lisinopril 10mg")

​
plan
string

Plan name to filter results by formulary coverage (e.g. "Aetna")

​
state
string

Two-letter state code to filter by regional availability (e.g. "CA")

Response

Search drugs response

​
succeeded
boolean
required

Whether the search was successful.

​
drugs
object[]
required

List of matching drugs.