Search Authorizations¶

Search authorization records by patient name, reference number, or organization.

Endpoint¶

GET /apis/soap-enrichment/v1/authorization/search

Query Parameters¶

Parameter	Type	Required	Description
`patientName`	string	No	Filter by patient name (partial match)
`authorizationReferenceNumber`	string	No	Filter by payer-issued authorization reference number
`organisationId`	integer	No	Filter by organization ID

Request¶

curl --location '{base_url}/apis/soap-enrichment/v1/authorization/search?organisationId=638&patientName=John' \
  --header 'Authorization: Bearer JWT_TOKEN'

Request Examples¶

Search by Reference Number¶

curl --location '{base_url}/apis/soap-enrichment/v1/authorization/search?authorizationReferenceNumber=AUTH-2026-001' \
  --header 'Authorization: Bearer JWT_TOKEN'

Search by Organization¶

curl --location '{base_url}/apis/soap-enrichment/v1/authorization/search?organisationId=638' \
  --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 ([]) when no records match the query.