Skip to main content
GET
Get a PA status check
Coming soon. This API may change before launch, including breaking changes.
Retrieve the current state and results of an asynchronous prior authorization status check.

Reading the response

The operation status is one of:
  • pending: processing is still underway.
  • completed: processing finished successfully.
  • failed: processing stopped and failure_reason explains why.
effective_processing_method is either instant or standard. For an instant_preferred request, a change from instant to standard indicates that fallback occurred. prior_authorizations is null while processing is pending or after it fails. When processing completes, it is an array of matching prior authorizations. An empty array means the check completed successfully and no prior authorizations were found; it is not an error or an inconclusive result. Each result exposes a normalized status of approved, denied, in_progress, or other, along with any available dates and decision notes. Vendor case IDs, source statuses, PBM names, and medication details are not returned.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

PA status check ID.

Minimum string length: 1

Response

Current PA status check state.

Successful response to GET /pa-status/{id}.

data
GetPaStatusResponseData · object
required

Response data returned when polling a PA status check.

status
string
default:success
Allowed value: "success"
error
null