Delete Invoice
const options = {
method: 'DELETE',
headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};
fetch('https://api.dcycle.io/v1/invoices/{invoice_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dcycle.io/v1/invoices/{invoice_id}"
headers = {
"x-api-key": "<x-api-key>",
"x-organization-id": "<x-organization-id>"
}
response = requests.delete(url, headers=headers)
print(response.text)curl --request DELETE \
--url https://api.dcycle.io/v1/invoices/{invoice_id} \
--header 'x-api-key: <x-api-key>' \
--header 'x-organization-id: <x-organization-id>'Delete Invoice
Delete an invoice from your organization
DELETE
/
v1
/
invoices
/
{invoice_id}
Delete Invoice
const options = {
method: 'DELETE',
headers: {'x-api-key': '<x-api-key>', 'x-organization-id': '<x-organization-id>'}
};
fetch('https://api.dcycle.io/v1/invoices/{invoice_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.dcycle.io/v1/invoices/{invoice_id}"
headers = {
"x-api-key": "<x-api-key>",
"x-organization-id": "<x-organization-id>"
}
response = requests.delete(url, headers=headers)
print(response.text)curl --request DELETE \
--url https://api.dcycle.io/v1/invoices/{invoice_id} \
--header 'x-api-key: <x-api-key>' \
--header 'x-organization-id: <x-organization-id>'← Invoices API
Permanently deletes an invoice and its associated emissions data. This action cannot be undone.
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.Permanent DeletionDeleting an invoice will permanently remove:
- The invoice record
- Associated emissions calculations
- Any linked data
inactive if you want to exclude it from calculations without permanent deletion.Request
Headers
string
required
Your API key for authenticationExample:
sk_live_1234567890abcdefstring
required
Your organization UUIDExample:
a8315ef3-dd50-43f8-b7ce-d839e68d51faPath Parameters
UUID
required
The unique identifier of the invoice to delete.Example:
550e8400-e29b-41d4-a716-446655440000Response
Returns204 No Content on successful deletion.
Example
curl -X DELETE "https://api.dcycle.io/v1/invoices/550e8400-e29b-41d4-a716-446655440000" \
-H "x-organization-id: ${DCYCLE_ORG_ID}" \
-H "x-api-key: ${DCYCLE_API_KEY}"
import requests
import os
invoice_id = "550e8400-e29b-41d4-a716-446655440000"
response = requests.delete(
f"https://api.dcycle.io/v1/invoices/{invoice_id}",
headers={
"x-organization-id": os.getenv("DCYCLE_ORG_ID"),
"x-api-key": os.getenv("DCYCLE_API_KEY"),
},
)
if response.status_code == 204:
print("Invoice deleted successfully")
const axios = require('axios');
const invoiceId = '550e8400-e29b-41d4-a716-446655440000';
axios.delete(
`https://api.dcycle.io/v1/invoices/${invoiceId}`,
{
headers: {
'x-organization-id': process.env.DCYCLE_ORG_ID,
'x-api-key': process.env.DCYCLE_API_KEY,
},
}
)
.then(response => {
if (response.status === 204) {
console.log('Invoice deleted successfully');
}
});
Common Errors
401 Unauthorized
Cause: Missing or invalid API key{"detail": "Invalid API key for organization", "code": "INVALID_API_KEY"}
403 Forbidden
Cause: The user is not a member of the organization, or invoice does not belong to this organization{"detail": "Logged User is not Member of Organization", "code": "LOGGED_USER_NOT_MEMBER"}
{
"detail": "Invoice does not belong to this organization",
"code": "INVOICE_ACCESS_DENIED"
}
404 Not Found
Cause: Invoice not found{"detail": "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.{
"detail": "A credit note cannot take a facility's consumption below zero: upload or keep the facility's invoices first",
"code": "NET_CONSUMPTION_NEGATIVE"
}
Related Endpoints
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
Was this page helpful?