v1
latestOpenAPI 3.1.02026-07-24233206489.1 KBInvoice Imports
Upload a CSV to start a bulk import
Starts a bulk invoice import. The request is multipart/form-data with a single required file part carrying the CSV (max 5 MiB, up to 1000 rows), e.g. curl -F "file=@july-invoices.csv". The response carries the new batch plus the detected column headers for the mapping step and a duplicate-upload warning. (The file part is described here rather than as a schema: the swag pipeline cannot attach the §10-required example to a binary multipart property.)
post/v1/invoices/imports
Response
Created
Example response
{
"data": {
"created_at": "2026-07-08 08:00:00+00:00",
"created_by": "org_abc123",
"detected_headers": [
"Customer Name",
"Email",
"Amount",
"Due Date"
],
"error_rows": 12,
"id": "imp_abc123",
"organization_id": "org_abc123",
"ready_rows": 248,
"source_filename": "july-invoices.csv",
"total_rows": 260,
"updated_at": "2026-07-08 08:05:00+00:00"
}
}