Insurance Discovery Check Results

Retrieve insurance discovery check results by `discoveryId`

GET/insurance-discovery/check/v1/{discoveryId}

You can use this endpoint to retrieve insurance discovery check results for a particular patient asynchronously.

You can begin polling immediately after receiving a PENDING status response from the synchronous Insurance Discovery Check endpoint. This endpoint can take up to 120 seconds to return a response.

It's unlikely for the insurance discovery process to take more than a few minutes, so it's rare to have to poll this endpoint more than once. However, if you receive a PENDING status, you can poll immediately again and continue polling until the status changes to COMPLETE.

Note that you should only expect to retrieve checks submitted within the last 24 hours. After 24 hours, the results may no longer be available.

Authorization
RequiredHeader

A production Stedi API Key for authentication.

Path Parameters

The unique ID for the insurance discovery check. Stedi returns this value in the response from the Insurance Discovery Check endpoint.

Response

application/json

The number of potential coverage matches for the patient. This will be 0 if Stedi didn't find any matching coverage.

A unique ID for this insurance discovery check. You can use it to retrieve the results asynchronously through the Insurance Discovery Check Results endpoint.

errors
Array of Objects

When a payer rejects your eligibility check, the response contains one or more AAA errors that specify the reasons for the rejection and any recommended follow-up actions.

Any errors that occur at the payer, provider, subscriber, or dependents levels are also included in this array, allowing you to review all errors in a central location. If there are no AAA errors, this array will be empty.

Array item
items
Array of Objects

An array of potential coverage matches for the patient. This will only be populated if the insurance discovery check status is COMPLETE. Each item in the array contains information about a potential match, including the provider, subscriber, payer, and plan information.

Array item
meta
Object

Metadata about the response. Stedi uses this data for tracking and troubleshooting.

Show attributes
status
String

The status of the discovery check. This is either PENDING or COMPLETE. - If the status is COMPLETE, the items array will contain any potential coverage matches Stedi found for the patient. - If the status is PENDING, the check is still in progress. You can immediately begin polling the Insurance Discovery Check Results endpoint to retrieve the results asynchronously.

Possible values
PENDING
COMPLETE
ERROR
warnings
Array of Objects

Issues with your insurance discovery check that may affect the results. For example, Stedi issues a warning when enrolling with a payer would improve the results for future requests.

Array item