Skip to main content
GET
/
v1
/
prior-authorizations
List prior authorizations
curl --request GET \
  --url https://api.example.com/v1/prior-authorizations \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "company_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "patient_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "patient_first_name": "<string>",
      "patient_last_name": "<string>",
      "patient_date_of_birth": "2023-12-25",
      "active": true,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "created_by_user_id": "<string>",
      "appeal_notes": "<string>",
      "appeal_number": "<string>",
      "appeal_availability": [
        {
          "day": "<string>",
          "start": "<string>",
          "end": "<string>"
        }
      ],
      "notes": "<string>",
      "payor_member_id": "<string>",
      "payor_insurance_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "payor_insurance": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "requesting_provider_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "servicing_provider_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "servicing_location_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "requesting_provider": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "npi": "<string>",
        "type": "<string>",
        "is_active": true,
        "tax_id": "<string>",
        "location": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>"
        }
      },
      "servicing_provider": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "npi": "<string>",
        "type": "<string>",
        "is_active": true,
        "tax_id": "<string>",
        "location": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>"
        }
      },
      "servicing_location": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "address": "<string>",
        "city": "<string>",
        "state": "<string>",
        "zip_code": "<string>",
        "address_2": "<string>"
      },
      "created_by_user": {
        "id": "<string>",
        "name": "<string>",
        "email": "<string>",
        "image": "<string>",
        "user_type": "<string>"
      },
      "service": {
        "service_type_codes": [
          "<string>"
        ],
        "start_date": "2023-12-25",
        "end_date": "2023-12-25",
        "cpt_codes": [
          {
            "code": "<string>",
            "units": "<string>",
            "unit_type": "units"
          }
        ],
        "locations": []
      },
      "result": {
        "start_date": "2023-12-25",
        "end_date": "2023-12-25",
        "cpt_codes": [
          {
            "code": "<string>",
            "units": "<string>",
            "unit_type": "units"
          }
        ],
        "locations": [],
        "authorization_number": "<string>",
        "reference_number": "<string>",
        "notes": "<string>",
        "ai_summary": "<string>",
        "ai_summary_generated_at": "2023-11-07T05:31:56Z"
      },
      "files": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "path": "<string>",
          "created_at": "2023-11-07T05:31:56Z",
          "display_name": "<string>",
          "type": "<string>",
          "size": 123,
          "metadata": {},
          "url": "<string>"
        }
      ],
      "file_count": 123,
      "submitted_at": "2023-11-07T05:31:56Z",
      "decided_at": "2023-11-07T05:31:56Z",
      "last_followed_up_at": "2023-11-07T05:31:56Z",
      "scheduled_submission_date": "2023-12-25",
      "completed": false,
      "completed_at": "2023-11-07T05:31:56Z",
      "completed_by_user_id": "<string>",
      "completed_by_user": {
        "id": "<string>",
        "name": "<string>",
        "email": "<string>",
        "image": "<string>",
        "user_type": "<string>"
      }
    }
  ],
  "has_more": true,
  "limit": 123
}

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
expand[]
enum<string>[] | null

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.

Allowed expand values for the PA LIST endpoint.

Same as PriorAuthorizationExpand minus files: the list path never loads or signs per-row files (only file_count), so files expansion is a single-resource-only operation. Excluding it here makes FastAPI reject ?expand[]=files on the list with a 422 rather than silently returning files: null.

Available options:
requesting_provider,
servicing_provider,
servicing_location
​
limit
integer
default:50
Required range: 1 <= x <= 100
​
starting_after
string<uuid> | null
​
ending_before
string<uuid> | null
​
prior_auth_id
string<uuid> | null
​
status
enum<string> | null

Lifecycle state of a prior authorization.

Available options:
pending,
in_review,
extra_information_needed,
decided,
cancelled
​
decision
enum<string> | null

Payor outcome on a decided authorization.

Available options:
approved,
partially_approved,
denied,
no_authorization_required
​
type
enum<string> | null

Authorization type.

Available options:
assessment,
treatment,
reassessment,
reassessment_and_treatment
​
patient_id
string<uuid> | null
​
insurance_id
string<uuid> | null
​
servicing_location_id
​
organization_id
​
search
string | null
​
date_from
string<date> | null
​
date_to
string<date> | null
​
expiration_filter
enum<string> | null

Filter for the listing endpoint by expiration window.

Available options:
all,
expiring,
expired
​
completion
enum<string>
default: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.

Available options:
outstanding,
completed,
all

Response

Successful Response

Cursor-paginated list of prior authorization records.

Stripe-style keyset pagination: no total or page. Use has_more to determine if another page exists. Fetch the next page by passing the id of the last record as starting_after; fetch the previous page by passing the id of the first record as ending_before.

​
data
PriorAuthorizationResponse · object[]
required
​
has_more
boolean
required
​
limit
integer
required