List prior authorizations

Return a paginated list of prior authorizations for your company. Filters narrow by status, decision, type, patient, servicing location, free-text patient name search, created-at date range, and expiration bucket.

expand[]PriorAuthorizationListExpand[] nullable

Relations to inline in each row. Repeatable, e.g. ?expand[]=requesting_provider&expand[]=servicing_location. files is not available here — use GET /{id} with expand[]=files.

limitinteger

starting_afterstring uuid nullable

ending_beforestring uuid nullable

prior_auth_idstring uuid nullable

status'pending' | 'submitted' | 'information_needed' | 'decided' | 'cancelled'

Lifecycle state of a prior authorization.

decision'approved' | 'partially_approved' | 'denied' | 'no_authorization_required'

Payor outcome on a decided authorization.

type'assessment' | 'treatment' | 'reassessment' | 'reassessment_and_treatment'

Authorization type.

patient_idstring uuid nullable

insurance_idstring uuid nullable

string uuid

OR

'none'

string uuid

OR

'none'

searchstring nullable

date_fromstring date nullable

date_tostring date nullable

expiring_within_daysinteger nullable

completion'outstanding' | 'completed' | 'all'

Filter the listing by the clinic-owned completion flag.

outstanding (default) hides done authorizations; completed shows only done; all ignores completion. Request-only — not a DB enum.

Response

Successful Response

has_moreboolean required

limitinteger required

Example response

{
  "data": [
    {
      "appeal_availability": [
        {
          "day": "monday",
          "start": "15:00",
          "end": "17:00"
        }
      ]
    }
  ]
}

v1

List prior authorizations

Query parameters

Response

Example response