Skip to content

List Authorizations for Case

Retrieve all authorization records associated with a specific patient case.

Endpoint

GET /apis/soap-enrichment/v1/authorization

Query Parameters

Parameter Type Required Description
case_id string Yes The spry_case_id of the case to retrieve authorizations for

Request

curl --location '{base_url}/apis/soap-enrichment/v1/authorization?case_id=SPRY_CASE_69cd0c97e7562d613ea89bc7' \
  --header 'Authorization: Bearer JWT_TOKEN'

Response

Success Response

Code: 200 OK

{
  "code": 2000,
  "data": [
    {
      "authorization_id": "auth_69cd0c97abc123",
      "authorization_reference_number": "AUTH-2026-001",
      "spry_case_id": "SPRY_CASE_69cd0c97e7562d613ea89bc7",
      "case_title": "Stable Burst Fracture",
      "plan_start_date": "2026-04-01T00:00:00",
      "plan_end_date": "2026-07-01T00:00:00",
      "effective_start_date": "2026-04-01T00:00:00",
      "effective_end_date": "2026-07-01T00:00:00",
      "insurance_payer": {
        "payer_reg_id": 2207,
        "name": "PEHP - Utah Public Employee Health Plan",
        "payer_id": "SX106",
        "payer_type": "COMMERCIAL"
      },
      "authorized_visit_count": 20,
      "current_visit_count": 5,
      "previous_consumed_visit_count": 0,
      "final_consumed_visit_count": 5,
      "phone_number": "8015551234",
      "fax_number": "8015555678",
      "comments": "Prior auth approved for MSK therapy",
      "authorization_status": "ACTIVE",
      "patient_id": 1172416,
      "patient_name": "John Doe",
      "organisation_id": 638,
      "clinic_id": 101,
      "icd_codes": [],
      "cpt_code_authorization_details": [],
      "created_at": "2026-04-01T12:00:00",
      "updated_at": "2026-04-10T09:30:00",
      "created_date": "2026-04-01T12:00:00Z"
    }
  ],
  "message": "Success"
}

Response Fields

Returns an array of authorization objects. Each object has the same fields as Get Authorization.

Returns an empty array ([]) if no authorizations exist for the case.

Error Response

Code: 200 OK

{
  "code": 4004,
  "data": null,
  "message": "Case not found"
}