> ## Documentation Index
> Fetch the complete documentation index at: https://docs.refactorbilling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Check Auth Status

> Retrieve prior authorization status for a visit.

## Authentication

All requests require an API key passed via the `x-api-key` header, along with a `tenant_id` query parameter.

<ParamField header="x-api-key" type="string" required>
  Your tenant API key.
</ParamField>

## Query Parameters

<ParamField query="tenant_id" type="integer" required>
  Your tenant ID.
</ParamField>

<ParamField query="visit_number" type="string" required>
  The visit number to look up authorization status for.
</ParamField>

## Response

<ResponseField name="visit_number" type="string">
  The visit number that was queried.
</ResponseField>

<ResponseField name="status" type="string">
  Call status. One of `completed`, `in_progress`, or `failed`.
</ResponseField>

<ResponseField name="payer_name" type="string">
  Name of the payer.
</ResponseField>

<ResponseField name="patient_name" type="string">
  Patient name on the claim.
</ResponseField>

<ResponseField name="auth_required" type="boolean">
  Whether prior authorization is required for this visit.
</ResponseField>

<ResponseField name="auth_number" type="string">
  The authorization/reference number issued by the payer.
</ResponseField>

<ResponseField name="auth_status" type="string">
  Current status of the authorization (e.g. `approved`, `pending`, `denied`, `expired`).
</ResponseField>

<ResponseField name="effective_date" type="string" format="date">
  Start date of the authorization period (YYYY-MM-DD).
</ResponseField>

<ResponseField name="expiration_date" type="string" format="date">
  End date of the authorization period (YYYY-MM-DD).
</ResponseField>

<ResponseField name="authorized_units" type="integer">
  Number of units authorized.
</ResponseField>

<ResponseField name="used_units" type="integer">
  Number of authorized units already used.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.refactorbilling.com/auth-status?tenant_id=1&visit_number=V12345" \
    -H "x-api-key: your-api-key"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "visit_number": "V12345",
    "status": "completed",
    "payer_name": "Blue Cross Blue Shield",
    "patient_name": "Jane Smith",
    "auth_required": true,
    "auth_number": "AUTH-2026-789012",
    "auth_status": "approved",
    "effective_date": "2026-01-01",
    "expiration_date": "2026-06-30",
    "authorized_units": 12,
    "used_units": 4
  }
  ```
</ResponseExample>