v1

latestOpenAPI 3.1.02026-07-24233206489.1 KB

Invoice Imports

Apply a column mapping

Maps each detected CSV column header onto a canonical invoice field, re-validates every row, and returns the batch with its new ready/error tally.

patch/v1/invoices/imports/{id}/mapping

Path parameters

idstring required

Import batch ID

Request body

mappingobject required

Example request

{
  "mapping": {
    "Customer Name": "customer_name",
    "Email": "customer_email"
  }
}

Response

has_moreboolean

Example response

{
  "data": {
    "created_at": "2026-07-08 08:00:00+00:00",
    "created_by": "org_abc123",
    "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"
  }
}