Skip to content

Delete Invoice

DELETE
/api/Invoices/{id}
curl --request DELETE \
--url https://example.com/api/Invoices/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
--header 'Authorization: Bearer <token>'

Deletes a Draft invoice. Sent or Paid invoices should be Voided instead - this is rejected.

The invoice is retained internally for history, but it is gone from this API: it disappears from the list endpoint and every read of it answers 404 afterwards. Its invoice number becomes free to reuse, and any transaction that referenced it keeps doing so.

id
required
string format: uuid

The invoice’s unique identifier.

Invoice deleted.

No invoice with the given ID exists, or it has already been deleted.

Media type application/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Example generated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

The invoice isn’t a Draft, so it can’t be deleted. Void it instead.

Media type application/json
object
type
string
nullable
title
string
nullable
status
integer format: int32
nullable
detail
string
nullable
instance
string
nullable
key
additional properties
Example generated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}