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.

​
Body

The request body should be a multipart/form-data upload with a single CSV file.
​
file
file
required
A CSV file containing 837 claim charge lines. Each row represents a single charge line; rows sharing the same provider_npi + claim_submitter_identifier are grouped into a single claim.

​
CSV Columns

ColumnTypeRequiredDescription
patient_namestringYesPatient full name
patient_dobdateYesPatient date of birth (YYYY-MM-DD, MM/DD/YYYY, etc.)
patient_genderstringYesPatient gender
provider_namestringYesProvider name
provider_addressstringYesProvider address
provider_npistringYesProvider NPI (used as part of unique key)
provider_tax_idstringNoProvider tax ID
patient_member_idstringYesPatient member/subscriber ID
payer_namestringNoPayer name
payer_identification_code_qualifierstringNoPayer ID code qualifier
payer_identification_codestringNoPayer identification code
claim_submitter_identifierstringYesClaim submitter identifier (used as part of unique key)
facility_code_valuestringYesFacility code
icd_codesstringYesICD codes, delimited by pipe, comma, or semicolon
phone_number_to_callstringYesPayer phone number (auto-formatted to E.164)
phone_number_descriptionstringYesDescription of the phone number
hcpcs_codestringYesHCPCS/CPT procedure code
monetary_amountnumberYesCharge amount
unitsnumberNoNumber of units
diagnosis_code_pointersstringNoDiagnosis code pointers, delimited by pipe, comma, or semicolon
service_date_fromdateNoService start date
service_date_todateNoService end date
modifiersstringNoProcedure modifiers, delimited by pipe, comma, or semicolon

​
Response

​
success
boolean
Whether the import completed successfully.
​
claim_ids
integer[]
List of created or updated claim IDs.
​
total_rows
integer
Total number of CSV rows processed.
​
total_claims
integer
Number of unique claims (grouped by provider_npi + claim_submitter_identifier).
curl -X POST "https://api.refactorbilling.com/claims-csv-import?tenant_id=1" \
  -H "x-api-key: your-api-key" \
  -F "file=@claims.csv"

{
  "success": true,
  "claim_ids": [101, 102, 103],
  "total_rows": 15,
  "total_claims": 3
}