Skip to main content
POST
Create a PA status check
Coming soon. This API may change before launch, including breaking changes.
Create an asynchronous check for prior authorizations associated with one patient, one medication NDC, and one or more insurance plans.

Processing methods

  • instant_only attempts only the instant method. If the request is ineligible or the instant attempt fails, the check ends with status: failed.
  • instant_preferred attempts the instant method first and may fall back to the standard method. Polling exposes the method currently handling the check as effective_processing_method.

Request requirements

  • prescription contains only the medication ndc.
  • insurances contains one or more insurance objects. Each object must include at least one non-empty discrete insurance field or a non-empty images list.
  • Each insurance image supplies exactly one of file_content or file_url.
  • Patient gender must be male, female, or other.
  • Entity information is not accepted by this endpoint.
The eventual successful response contains operation metadata only. Retrieve the prior authorization results by polling the returned ID.

Authorizations

Authorization
string
header
required

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

Body

application/json
processing_method
enum<string>
required

Requested processing policy. instant_only fails if instant processing cannot produce a result; instant_preferred permits standard fallback.

Available options:
instant_only,
instant_preferred
patient
PaStatusPatient · object
required
provider
PaStatusProvider · object
required
prescription
PaStatusPrescription · object
required
insurances
PaStatusInsurance · object[]
required

Insurance plans to check for the requested NDC.

Minimum array length: 1

Discrete insurance data and images for one plan.

priority
integer
default:2

Lower values indicate higher processing priority.

Required range: 0 <= x <= 3

Response

PA status check created; returns its current processing state.

Successful response to POST /pa-status.

data
CreatePaStatusResponseData · object
required

Response metadata returned after creating a PA status check.

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