Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Start or resume an upload of up to 100,000 rows
debts:write. Uses the write limiter: 500 requests/hour per company. The request body is limited to 10 MB.
curl -X POST "https://getbill.io/external-api/v1/campaigns/client-a-2026/snapshots/export-2026-07-17-550e8400/start" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"expected_row_count":2500}'
HTTP/1.1 201 Created
Location: /external-api/v1/campaigns/client-a-2026/snapshots/export-2026-07-17-550e8400
{
"error": false,
"message": "Snapshot upload started",
"data": {
"api_reference": "client-a-2026",
"snapshot_reference": "export-2026-07-17-550e8400",
"delivery_mode": "staged",
"status": "uploading",
"core_applied": false,
"expected_row_count": 2500,
"received_row_count": 0,
"received_chunk_count": 0,
"next_chunk_index": 0,
"counts": null,
"failure": null,
"created_at": "2026-07-17T09:00:00Z",
"updated_at": "2026-07-17T09:00:00Z",
"status_url": "/external-api/v1/campaigns/client-a-2026/snapshots/export-2026-07-17-550e8400"
}
}
200 with the existing status. A changed count returns 409 snapshot_reference_conflict. A reference already used for one-request delivery returns snapshot_delivery_mode_conflict.
Only a new 201 response includes Location; status_url is present in both responses.