Skip to navigation
API ReferencePre Encounter Eligibility Checks V1

Pre Encounter Eligibility Checks V 1 Insurance Discovery

Sends an insurance discovery check to find potential coverage matches for a patient through Stedi. Given patient demographics, this endpoint discovers what insurance coverages exist for the patient. We recommend using the coverages check_insurance_discovery_passthrough API, as it allows long-running discovery requests to complete.

Authentication

AuthorizationBearer
Send your Taiga API key as a Bearer token. Create and manage keys in the Taiga developer portal.

Request

This endpoint expects an object.
providerobjectRequired
Information about the provider requesting the insurance discovery check.
subscriberobjectRequired

Demographic information for the patient when they are the health plan subscriber. Providing as much information as possible improves the probability of finding matching coverage. SSN and address (especially zip code) are strongly recommended.

dependentobject or nullOptional
Demographic information for the patient when they are a dependent on a health plan. If you only have the dependent's information, identify them in the subscriber object instead and leave this empty.
encounterobject or nullOptional

The date range for the service. If not specified, Stedi defaults to the current date. You can specify either a single date_of_service or a beginning_date_of_service and end_date_of_service.

Response

discovery_idstring or nullOptional
A unique ID for this insurance discovery check.
statusenum or nullOptional
The status of the discovery check. COMPLETE means items are populated. PENDING means the check is still in progress.
Allowed values:
itemslist of any or nullOptional

An array of potential coverage matches for the patient. Only populated when status is COMPLETE. Each item is a raw passthrough of Stedi’s deeply nested coverage-match object (provider, subscriber, payer, plan, and benefits details).

parsed_itemslist of objects or nullOptional
coverages_foundinteger or nullOptional
The number of potential coverage matches found. 0 if no matching coverage was found.
errorslist of objects or nullOptional