Search Payers
Search insurance payers for autocomplete and capture the payer ID alongside the payer name.
GET /api/v1/partner/payers/search?q={query}Search insurance payers by name so you can autocomplete the insurance carrier in your app and store the payer's electronic ID when available.
Use this endpoint to populate patient.insurance.payerName and, when available, patient.insurance.payerId. payerName should be the insurance carrier name like "Cigna" or "Aetna"; it is not the plan/product name like "PPO Select Plus".
Query parameters
| Parameter | Required | Description |
|---|---|---|
q | Yes | Search text. Must be at least 2 characters. |
Request
const response = await fetch(
"https://api.usetaiga.com/api/v1/partner/payers/search?q=cigna",
{
headers: {
"Authorization": "Bearer YOUR_API_KEY",
},
}
);
const data = await response.json();curl "https://api.usetaiga.com/api/v1/partner/payers/search?q=cigna" \
-H "Authorization: Bearer YOUR_API_KEY"Response
{
"payers": [
{
"payerId": "62308",
"payerName": "Cigna",
"avatarUrl": "https://..."
}
]
}| Field | Description |
|---|---|
payerId | Payer's electronic ID. Strongly recommended for claim routing. |
payerName | Insurance carrier name to send as patient.insurance.payerName. |
avatarUrl | Optional payer logo URL. |
Errors
| Status | Cause |
|---|---|
400 | Missing query or fewer than 2 characters |
401 | Invalid or missing API key |
500 | Upstream payer search failed |