> ## 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 Appeal Status

> Follow up on submitted appeals to get the current status and expected decision timeline.

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

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

<ResponseField name="appeal_reference_number" type="string">
  Payer-assigned reference number for the appeal.
</ResponseField>

<ResponseField name="appeal_status" type="string">
  Current status of the appeal (e.g. `received`, `in_review`, `approved`, `denied`, `partially_approved`).
</ResponseField>

<ResponseField name="appeal_level" type="string">
  Level of appeal (e.g. `first_level`, `second_level`, `external_review`).
</ResponseField>

<ResponseField name="date_submitted" type="string" format="date">
  Date the appeal was submitted (YYYY-MM-DD).
</ResponseField>

<ResponseField name="expected_decision_date" type="string" format="date">
  Expected date for the appeal decision (YYYY-MM-DD).
</ResponseField>

<ResponseField name="reviewer_notes" type="string">
  Notes from the payer's appeal reviewer, if available.
</ResponseField>

<ResponseField name="additional_documentation_needed" type="string[]">
  Any additional documentation requested by the payer to process the appeal.
</ResponseField>

<ResponseField name="original_denial_reason" type="string">
  The original denial reason that prompted the appeal.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.refactorbilling.com/check-appeal-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",
    "patient_name": "Maria Garcia",
    "payer_name": "Cigna",
    "appeal_reference_number": "APL-2026-034821",
    "appeal_status": "in_review",
    "appeal_level": "first_level",
    "date_submitted": "2026-02-20",
    "expected_decision_date": "2026-03-20",
    "reviewer_notes": "Clinical documentation received and under medical director review.",
    "additional_documentation_needed": [],
    "original_denial_reason": "Service not medically necessary (CO-50)"
  }
  ```
</ResponseExample>