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

# Introduction

> Refactor API documentation — automate payer calls for claims, denials, and authorizations.

## Welcome to the Refactor API

The Refactor API lets you programmatically trigger and retrieve results from AI-powered payer phone calls. Import claims, verify coverage, follow up on claim status, resolve denials, and check authorization status — all through a simple REST API.

## Authentication

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

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

## Key Parameters

| Parameter      | Description                             |
| -------------- | --------------------------------------- |
| `tenant_id`    | Your Refactor-assigned organization ID. |
| `visit_number` | Your internal identifier for the visit. |

## Call Status

Every endpoint that returns call information contains a `status` field indicating the call result:

| Status        | Description                             |
| ------------- | --------------------------------------- |
| `completed`   | Call finished successfully with results |
| `in_progress` | Call is currently being made            |
| `failed`      | Call could not be completed             |

## Data Import

<CardGroup cols={1}>
  <Card title="Import Claims" icon="file-import" href="/claims-csv-import">
    Submit claims via JSON and automatically schedule payer calls.
  </Card>
</CardGroup>

## Pre-Service

<CardGroup cols={3}>
  <Card title="Verify Coverage" icon="shield-check" href="/verify-coverage">
    Confirm active coverage, plan type, and benefit details.
  </Card>

  <Card title="Verify Auth Requirements" icon="clipboard-check" href="/verify-auth-requirements">
    Check whether prior authorization is required for a procedure.
  </Card>

  <Card title="Check Auth Status" icon="key" href="/auth-status">
    Check the status of submitted prior authorization requests.
  </Card>
</CardGroup>

## Claim Follow-Up

<CardGroup cols={2}>
  <Card title="Check Claim Status" icon="file-invoice" href="/claim-status">
    Get real-time updates on claim adjudication and payment details.
  </Card>

  <Card title="Check Appeal Status" icon="scale-balanced" href="/check-appeal-status">
    Follow up on submitted appeals and get expected decision timelines.
  </Card>
</CardGroup>

## Denial Management

<CardGroup cols={1}>
  <Card title="Get Denial Clarification" icon="circle-question" href="/denial-clarification">
    Get denial details and recommended actions for a visit.
  </Card>
</CardGroup>