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 look up authorization status for.

​
Response

​
visit_number
string
The visit number that was queried.
​
payer_name
string
Name of the payer.
​
patient_name
string
Patient name on the claim.
​
auth_required
boolean
Whether prior authorization is required for this visit.
​
auth_number
string
The authorization/reference number issued by the payer.
​
auth_status
string
Current status of the authorization (e.g. approved, pending, denied, expired).
​
effective_date
string
Start date of the authorization period (YYYY-MM-DD).
​
expiration_date
string
End date of the authorization period (YYYY-MM-DD).
​
authorized_units
integer
Number of units authorized.
​
used_units
integer
Number of authorized units already used.
curl -X GET "https://api.refactorbilling.com/auth-status?tenant_id=1&visit_number=V12345" \
  -H "x-api-key: your-api-key"

{
  "visit_number": "V12345",
  "payer_name": "Blue Cross Blue Shield",
  "patient_name": "Jane Smith",
  "auth_required": true,
  "auth_number": "AUTH-2026-789012",
  "auth_status": "approved",
  "effective_date": "2026-01-01",
  "expiration_date": "2026-06-30",
  "authorized_units": 12,
  "used_units": 4
}