Skip to main content
Python
import requests

url = 'https://api.simplex.sh/pa_search_providers'
headers = {
    'X-API-Key': 'your_api_key_here'
}
params = {
    'credential_name': 'my_availity_creds',
    'payer_id': 'bcbs_tx',
    'npi': '1528074691'
}

response = requests.get(url, headers=headers, params=params)
result = response.json()
for prov in result['providers']:
    print(f"{prov['npi']}: {prov['first_name']} {prov['last_name']}{prov['specialty']}")
    print(f"  In-network: {prov['in_network']}")
    for addr in prov['addresses']:
        print(f"  {addr['line1']}, {addr['city']}, {addr['state']} {addr['zip']}")
{
  "succeeded": true,
  "providers": [
    {
      "npi": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "tax_id": "<string>",
      "specialty": "<string>",
      "in_network": true,
      "addresses": [
        {
          "line1": "<string>",
          "city": "<string>",
          "state": "<string>",
          "zip": "<string>"
        }
      ],
      "middle_name": "<string>"
    }
  ]
}
You can search by NPI for an exact match or by name for a fuzzy search. The response includes the provider’s tax_id, specialty, and full address — all required fields for prior auth submission.
Provider search results are payer-specific. The same NPI may return different network status or address information depending on the payer. Always pass the payer_id for the payer you intend to submit the prior auth to.

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.

payer_id
string
required

The payer to search against. Provider network status and available addresses are payer-specific.

npi
string

Exact NPI number to search for (e.g. "1528074691"). Provide either npi or name.

name
string

Partial or full provider name to search for (e.g. "Patel", "Ravi Patel"). Provide either npi or name.

member_id
string

Member ID for payer-specific context. Required by some payers to return accurate network status.

Response

200 - application/json

Search providers response

succeeded
boolean
required

Whether the search was successful.

providers
object[]
required

List of matching providers.