Skip to main content
POST
Bulk Delete

Bulk Delete

Delete multiple invoices by their IDs. Invoices must belong to the specified facility and match the given type. Related emission records and distributed siblings are automatically cleaned up.

Request

Headers

string
required
Your API key for authenticationExample: sk_live_1234567890abcdef
string
required
Your organization UUIDExample: a8315ef3-dd50-43f8-b7ce-d839e68d51fa

Body Parameters

string[]
required
Array of invoice UUIDs to delete (1–100,000)
string
required
UUID of the facility the invoices belong to
string
required
Invoice type: electricity, heat, water, recharge

Response

integer
Number of invoices successfully deleted
string[]
UUIDs of successfully deleted invoices
integer
Number of invoices that failed to delete
string[]
UUIDs of invoices that failed to delete
string
Human-readable summary message

Example

Successful Response

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

403 Forbidden

Cause: The authenticated user is not a member of the organization

422 Unprocessable Entity

Cause: Missing required fields or invalid invoice type

Bulk Delete Preview

Preview what will be deleted before confirming

Bulk Delete by Filters

Delete invoices matching filter criteria