Skip to main content

​
Authentication

All requests require an API key passed via the x-api-key header, along with a tenant_id query parameter.
​
x-api-key
string
required
Your tenant API key.

​
Query Parameters

​
tenant_id
integer
required
Your tenant ID.
​
visit_number
string
required
The visit number to check appeal status for.

​
Response

​
visit_number
string
The visit number that was queried.
​
status
string
Call status. One of completed, in_progress, or failed.
​
patient_name
string
Patient name on the claim.
​
payer_name
string
Name of the insurance payer.
​
appeal_reference_number
string
Payer-assigned reference number for the appeal.
​
appeal_status
string
Current status of the appeal (e.g. received, in_review, approved, denied, partially_approved).
​
appeal_level
string
Level of appeal (e.g. first_level, second_level, external_review).
​
date_submitted
string
Date the appeal was submitted (YYYY-MM-DD).
​
expected_decision_date
string
Expected date for the appeal decision (YYYY-MM-DD).
​
reviewer_notes
string
Notes from the payer’s appeal reviewer, if available.
​
additional_documentation_needed
string[]
Any additional documentation requested by the payer to process the appeal.
​
original_denial_reason
string
The original denial reason that prompted the appeal.
curl -X GET "https://api.refactorbilling.com/check-appeal-status?tenant_id=1&visit_number=V12345" \
  -H "x-api-key: your-api-key"

{
  "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)"
}