Sign in
invoices

Bulk-approve invoices

Submits multiple invoices for asynchronous approval. Returns a batch_id for polling progress via GET /v1/batch/{batch_id}/progress and retrieving per-invoice results via GET /v1/batch/{batch_id}/results.

post/invoices/bulk-approve

Headers

Authorizationstring required

OAuth2 authentication flows. Auth server URLs will vary by environment

X-Api-Keystring required

API key for authentication

X-API-Versionstring

API version to use (optional, defaults to latest). Supported values: 1.0.0, 1.1.0.

Idempotency-Keystring

Client-generated unique key (UUID/ULID recommended). JSON requests: the first 2xx response is cached for 24h and replayed on a same-key retry with a matching body; a different body returns 422. Non-JSON requests (e.g. file uploads): the key is single-use — any same-key retry returns 422 regardless of body. See Idempotency for full details.

Request body

invoice_idsstring[] required

Invoice IDs to approve (max 100 per request)

force_approveboolean

Force-approve regardless of policy state (requires elevated permission; default false)

Response

Batch accepted for asynchronous processing

InvoicesPostInvoicesBulkApproveResponse202 required

Empty response body

Changes