InvoiceChaser API

The API is included in the Pro plan. Create a key on your account page, then send it as a Bearer token. Jobs created through the API share the same monthly file allowance as the web tool, and every export artifact can be downloaded individually.

Create a job

Multipart upload, one or more invoice CSV files in the files field:

curl -X POST https://invoicechaser.xyz/api/v1/jobs \
  -H "Authorization: Bearer ic_live_..." \
  -F "files=@invoices.csv"

The response is the finished job (processing is synchronous): status, the per-file aging summary (rows, totals, buckets, overdue, late fees, emails due), the issue list with line numbers, and the list of artifacts written.

Read a job

curl https://invoicechaser.xyz/api/v1/jobs/<job-id> \
  -H "Authorization: Bearer ic_live_..."

Download an export

kind is one of aging (aging-report.csv), emails (emails.csv index), summary (summary.json) or email (one reminder .txt — also pass email=email-NNNN-sN.txt); file is the stored input file name from the job:

curl -L "https://invoicechaser.xyz/api/v1/jobs/<job-id>/download?file=invoices.csv&kind=aging" \
  -H "Authorization: Bearer ic_live_..." \
  -o aging-report.csv

Notes

• Files are kept for 72 hours after processing, then deleted.
• Plan limits (files per month, batch size, file size) apply exactly as on the web tool and are enforced on the server.
• The API always has the full 6-stage email pack (Pro plan); the web tool gates stages 3–6 to Starter and Pro.
• A key whose owner drops below Pro stops working with a 403 until the plan includes API access again — the key itself stays valid.