Delete Transaction

DELETE /api/v1/transactions/:id

Deletes a transaction permanently.

Warning: This action cannot be undone. The transaction will be permanently deleted.

Path Parameters

ParameterTypeDescription
idstringTransaction ID

Example Request

curl -X DELETE "https://statements.finopsbricks.com/api/v1/transactions/abc123xyz789" \
  -H "api-key: fob_stm_xxxxxxxxxxxx" \
  -H "api-secret: xxxxxxxxxxxxxxxx"

Response

Returns 204 No Content on success.

What Happens

When a transaction is deleted:

  1. The transaction is permanently removed from the database
  2. It will no longer appear in lists or reports
  3. The statement it came from is not affected
  4. This action cannot be undone

Bulk Delete

To delete multiple transactions, call this endpoint for each transaction ID. There is currently no bulk delete endpoint.

Errors

CodeDescription
401Invalid or missing API credentials
403API key lacks transactions:delete permission
404Transaction not found