Skip to main content
POST
Decide a pre-authorization request

Authorizations

Authorization
string
header
required

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

Headers

Idempotency-Key
string
required

A unique value you choose for this request, such as a UUID. Sending the same key again returns the first answer instead of doing the work twice, so a timed-out request is safe to retry. Reusing a key for a different request is refused with 409 idempotency_key_conflict, and retrying while the first request is still running with 409 idempotency_key_reused. See Retries and idempotency.

Minimum string length: 1

Path Parameters

clinic_id
string<uuid>
required
pa_id
string<uuid>
required

Body

application/json

Decide a request that is sent_for_authorization. An approval needs pa_code; a denial needs reason. approved_amount (approval only) defaults to the estimated cost and may not exceed it. Lines you do not list follow the decision. A decided request cannot be decided again.

decision
enum<string>
required
Available options:
approved,
denied
pa_code
string
Maximum string length: 100
approved_amount
number
Required range: x >= 0
reason
string
Maximum string length: 1000
items
object[]
Maximum array length: 500

Response

OK.

data
object
required

A pre-authorization request the clinic sent to an insurer. status is sent_for_authorization until the insurer decides, then approved or denied (with pa_code on approval). items and diagnoses are on the single read only.

idempotent_replay
boolean

Present and true when this Idempotency-Key was already used and the original answer is returned.