Bulk Delete
Bulk Delete
Delete multiple invoices by ID
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_1234567890abcdefstring
required
Your organization UUIDExample:
a8315ef3-dd50-43f8-b7ce-d839e68d51faBody 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, rechargeResponse
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 key403 Forbidden
Cause: The authenticated user is not a member of the organization422 Unprocessable Entity
Cause: Missing required fields or invalid invoice typeRelated Endpoints
Bulk Delete Preview
Preview what will be deleted before confirming
Bulk Delete by Filters
Delete invoices matching filter criteria