Delete a draft transaction

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

Permanently deletes a draft transaction and its lines. Only transactions with status: "draft" and sourceType: "manual" can be deleted.

System-generated transactions (from invoices or bank imports) cannot be deleted directly. Delete or cancel the source document instead. This preserves the audit trail.

Path parameters

idstringrequired

Transaction ID (e.g. txn_42). Must use the transaction prefix.

Response

200Transaction and all journal lines permanently deleted.

Show response fields

deletedboolean

Error codes

400Transaction is not in draft status, or is system-generated (delete the source document instead).

404Transaction not found.

RequestDELETE/v1/transactions/{id}curl

curl -X DELETE https://api.speybooks.com/v1/transactions/txn_99 \
  -H "Authorization: Bearer sk_test_..."

Response200

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