Skip to main content

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.

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

​
Request Body

Submit an array of claims. Each claim contains claim-level fields and an array of charge lines. Claims are uniquely identified by the combination of provider_npi + claim_submitter_identifier.
​
claims
Claim[]
required
Array of claims to import.

​
Response

​
success
boolean
Whether the import completed successfully.
​
claim_ids
integer[]
List of created or updated claim IDs.
​
total_claims
integer
Number of claims processed.
curl -X POST "https://api.refactorbilling.com/claims-import?tenant_id=1" \
  -H "x-api-key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "claims": [
      {
        "patient_name": "John Doe",
        "patient_dob": "1985-04-12",
        "patient_gender": "M",
        "provider_name": "Dr. Smith",
        "provider_address": "123 Medical Dr, Suite 100, San Francisco, CA 94102",
        "provider_npi": "1234567890",
        "patient_member_id": "MEM987654",
        "payer_name": "Aetna",
        "claim_submitter_identifier": "CLM-2026-001",
        "facility_code_value": "11",
        "icd_codes": ["M54.5", "G89.29"],
        "visit_number": "V12345",
        "payer_phone_number": "+18005551234",
        "charge_lines": [
          {
            "hcpcs_code": "99213",
            "monetary_amount": 150.00,
            "units": 1,
            "diagnosis_code_pointers": ["1"],
            "service_date_from": "2026-03-01",
            "service_date_to": "2026-03-01",
            "modifiers": ["25"]
          },
          {
            "hcpcs_code": "20610",
            "monetary_amount": 250.00,
            "units": 1,
            "diagnosis_code_pointers": ["1", "2"],
            "service_date_from": "2026-03-01",
            "service_date_to": "2026-03-01"
          }
        ]
      }
    ]
  }'

{
  "success": true,
  "claim_ids": [101],
  "total_claims": 1
}