Build eligibility and prior authorization into your workflow
Kairos provides structured APIs for real-time eligibility and benefits checks, prior authorization intake, document collection, clarification, and decision tracking.
Eligibility & benefits
Check coverage, plan details, deductibles, out-of-pocket amounts, copays, and coinsurance.
Read the API referencePrior authorization
Create PA cases, upload supporting documents, validate packets, resolve tasks, and track payer outcomes.
Read the API referenceAuthentication
Keep API keys in server-side environments and never expose them in browser code. The current
eligibility contract accepts either X-API-Key or a bearer token. The prior
authorization v1 preview uses a bearer token.
curl -X POST https://api.kairosagents.ai/api/eligibility \
-H "X-API-Key: $KAIROS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"subscriber":{"external_id":"patient-456","first_name":"Jane","last_name":"Doe","date_of_birth":"1980-03-04"},"insurance":{"payer_name":"Aetna","member_id":"ABC123","group_number":null},"provider":{"npi":"1234567893"},"service":{"date_of_service":"2026-09-09","service_type_codes":["30"]}}'Conventions
Dates
ISO 8601. Calendar dates use YYYY-MM-DD; timestamps use UTC.
Errors
Branch on stable error.code values and use retriable for retry behavior.
Traceability
Log request_id for eligibility and trace_id for PA calls, then include it when contacting support.
Versioning
The prior authorization preview places its major API version in the URL under
/v1. Its additive fields may grow within v1, but Kairos will not remove fields
or change their meaning without a new major version.
The existing eligibility draft remains at /api/eligibility while that contract is
reviewed. Clients should not send an X-Kairos-Version header to either API.
Preview access. These contracts are available for integration planning. Contact Kairos for sandbox availability and onboarding.