> ## 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.

# Verify Auth Requirements

> Check whether prior authorization is required for a specific procedure and patient.

## 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 check authorization requirements 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="patient_name" type="string">
  Patient name on the claim.
</ResponseField>

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

<ResponseField name="procedure_code" type="string">
  CPT/HCPCS procedure code being checked.
</ResponseField>

<ResponseField name="procedure_description" type="string">
  Human-readable description of the procedure.
</ResponseField>

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

<ResponseField name="auth_submission_method" type="string">
  How to submit the authorization request (e.g. `portal`, `phone`, `fax`).
</ResponseField>

<ResponseField name="auth_turnaround_days" type="integer">
  Expected turnaround time for authorization decision in business days.
</ResponseField>

<ResponseField name="required_documentation" type="string[]">
  List of documents required for the authorization request.
</ResponseField>

<ResponseField name="notes" type="string">
  Additional notes or instructions from the payer representative.
</ResponseField>

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "visit_number": "V12345",
    "status": "completed",
    "patient_name": "John Doe",
    "payer_name": "UnitedHealthcare",
    "procedure_code": "27447",
    "procedure_description": "Total knee replacement",
    "auth_required": true,
    "auth_submission_method": "portal",
    "auth_turnaround_days": 5,
    "required_documentation": [
      "Operative report",
      "Clinical notes demonstrating conservative treatment failure",
      "Imaging results (X-ray or MRI)"
    ],
    "notes": "Authorization valid for 60 days from approval date. Must be submitted at least 10 business days before scheduled procedure."
  }
  ```
</ResponseExample>