---
title: "Delete an invoice"
method: DELETE
path: "/v1/invoices/{invoiceId}"
tags: ["Invoices"]
---

# Delete an invoice

`DELETE /v1/invoices/{invoiceId}`

## Request

- Base URL: `https://api.frihet.io`
- URL: `https://api.frihet.io/v1/invoices/{invoiceId}`
- Auth: API key in header `X-API-Key`

Delete an invoice. Draft invoices are permanently deleted (204).
Non-draft invoices are soft-deleted (cancelled) to preserve VeriFactu
SHA-256 hash chain integrity (RD 1007/2023 compliance), returning 200
with the cancelled document body.

## Path parameters

- `invoiceId` string, required

## Response `200`

Invoice soft-deleted (cancelled). Returned for non-draft invoices.

- object
  - `data` object
    - `id` string
    - `status` string
    - `cancelledVia` string
  - `meta` object
    - `requestId` string
    - `timestamp` string, date-time

## Other responses

- `204`: Invoice permanently deleted (draft invoices only)
- `401`: Authentication required or invalid API key
- `404`: Resource not found
- `429`: Rate limit exceeded (100 requests per minute)
- `500`: Internal server error

---

[API](https://skmtc.dev/frihet/apis/frihet-api.md) · [All operations](https://skmtc.dev/frihet/apis/frihet-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frihet/apis/frihet-api/revisions/3dd37f6a72d1?raw)