Delete a draft invoice

DELETEhttps://app.speybooks.com/api/v1/invoices/{id}

Permanently deletes a draft invoice and its line items. Only invoices with status draft can be deleted; an issued invoice cannot be deleted, and a missing invoice is reported as not found.

This action is irreversible. An issued invoice cannot be deleted or cancelled (cancellation is draft-only): close an unpaid issued invoice with written_off. Issued invoices are preserved for the audit trail.

Path parameters

idstringrequired

Response

200Default Response

Show response fields

deletedboolean

Error codes

400Default Response

404Invoice not found.

RequestDELETE/v1/invoices/{id}curl

curl -X DELETE https://api.speybooks.com/v1/invoices/inv_44 \
  -H "Authorization: Bearer sk_live_..."

Response200

{
  "success": true,
  "data": {
    "deleted": true
  }
}