---
title: "Delete an invoice"
method: DELETE
path: "/public/v1/invoices/{id}"
tags: ["Invoice"]
---

# Delete an invoice

`DELETE /public/v1/invoices/{id}`

Deletes an invoice. This is a hard delete: the invoice is permanently removed together with its line items, charges, and payments — it disappears from `GET /public/v1/invoices`, `GET /public/v1/invoices/{id}` returns 404 for it, and it cannot be recovered through the API. Responds 204 with no body on success, or 404 if no invoice with that `id` exists in your company (including one that belongs to another company or was already deleted). A VOIDED invoice can be deleted too. Any custom validation rule your company has configured for invoice deletion can refuse the delete with a 400, in which case nothing is changed.

Effects on payments and credits, all in one atomic call: every payment recorded on the invoice (voided ones included) is deleted with it. [Credit](#model-credit) balance that was applied to the invoice through those payments is released back onto the credits, and credits that were generated by overpaying this invoice are canceled.

The [order](#model-order) the invoice bills is untouched: it keeps its status and line items, and its invoiced and paid totals simply no longer include this invoice, so the order can be invoiced again. If your company is integrated with QuickBooks Online, the linked QuickBooks Online invoice and its payments are scheduled for deletion there too (that sync is eventual — observe it in QuickBooks Online, not in the 204). Files attached to the invoice are detached but kept. Nothing is synced to Metrc or BioTrack.

Required permission: `invoices_permissions_delete` (plus access to the invoice under team restrictions).

## Path parameters

- `id` string, required

## Response `204`

No Content

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission
- `404` — Not Found

---

[API](https://skmtc.dev/distru/apis/distru-api.md) · [All operations](https://skmtc.dev/distru/apis/distru-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/distru/distru-api/revisions/f8930b2c2924/schema)