Skip to main content
DELETE
Delete Invoice
← Invoices API
Deprecated. Use POST /v2/invoices/delete: up to 5,000 invoices of any category per request, idempotent, deleted asynchronously, with webhooks. This endpoint keeps working; its responses carry Deprecation and Link: </v2/invoices/delete>; rel="successor-version" headers. A removal date (Sunset) will be announced in the changelog with notice.
Permanently deletes an invoice and its associated emissions data. This action cannot be undone.
Permanent DeletionDeleting an invoice will permanently remove:
  • The invoice record
  • Associated emissions calculations
  • Any linked data
This action cannot be reversed. Consider setting the invoice status to inactive if you want to exclude it from calculations without permanent deletion.

Request

Headers

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

Path Parameters

UUID
required
The unique identifier of the invoice to delete.Example: 550e8400-e29b-41d4-a716-446655440000

Response

Returns 204 No Content on successful deletion.

Example

Common Errors

401 Unauthorized

Cause: Missing or invalid API key

403 Forbidden

Cause: The user is not a member of the organization, or invoice does not belong to this organization

404 Not Found

Cause: Invoice not found

422 Net consumption below zero

Cause: Deleting the invoice would take its facility’s consumption of the same energy (same fuel and unit, all its invoices added up) below zero, because of the credit notes (negative invoices) still there. Delete the credit notes first.

List Invoices

Retrieve all invoices with filtering

Get Invoice

Get a single invoice by ID

Bulk Delete

Delete multiple invoices at once

Update Invoice

Modify invoice details instead of deleting