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

> Confirm active coverage, plan type, and benefit details for a 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 verify coverage 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="member_id" type="string">
  Patient's member/subscriber ID.
</ResponseField>

<ResponseField name="group_number" type="string">
  Insurance group number.
</ResponseField>

<ResponseField name="plan_type" type="string">
  Type of insurance plan (e.g. `PPO`, `HMO`, `EPO`, `POS`).
</ResponseField>

<ResponseField name="coverage_active" type="boolean">
  Whether the patient's coverage is currently active.
</ResponseField>

<ResponseField name="effective_date" type="string" format="date">
  Coverage effective date (YYYY-MM-DD).
</ResponseField>

<ResponseField name="termination_date" type="string" format="date">
  Coverage termination date, if applicable (YYYY-MM-DD).
</ResponseField>

<ResponseField name="copay" type="number">
  Copay amount for the service type.
</ResponseField>

<ResponseField name="coinsurance_percent" type="number">
  Coinsurance percentage the patient is responsible for.
</ResponseField>

<ResponseField name="deductible_remaining" type="number">
  Remaining deductible amount for the benefit period.
</ResponseField>

<ResponseField name="out_of_pocket_remaining" type="number">
  Remaining out-of-pocket maximum for the benefit period.
</ResponseField>

<ResponseField name="in_network" type="boolean">
  Whether the rendering provider is in-network for this plan.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.refactorbilling.com/verify-coverage?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": "Jane Smith",
    "payer_name": "Blue Cross Blue Shield",
    "member_id": "BCB987654321",
    "group_number": "GRP-44210",
    "plan_type": "PPO",
    "coverage_active": true,
    "effective_date": "2025-01-01",
    "termination_date": null,
    "copay": 30.00,
    "coinsurance_percent": 20,
    "deductible_remaining": 450.00,
    "out_of_pocket_remaining": 3200.00,
    "in_network": true
  }
  ```
</ResponseExample>