Delete an Invoice
DELETE /api/v1/invoices/:id
Permanently delete an invoice. This action is irreversible and will also delete associated payments and reminders if not already processed.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
integer | Yes | The unique ID of the invoice. |
Request Example
DELETE /api/v1/invoices/123 HTTP/1.1
Host: koteshen.com
Authorization: Bearer {access_token}
Content-Type: application/json
Accept: application/json
Response
Status Codes:
204 No Content- Invoice deleted successfully.401 Unauthorized- Invalid or missing token.404 Not Found- Invoice not found.422 Unprocessable Entity- Cannot delete (e.g., paid invoices).
Success Response (204)
Empty body.
Error Response Example (422)
{ "errors": [] }