Delete transactions by date range

DELETE/api/v1/transactions/by-date-range

Permanently delete every transaction for the current business whose date falls between start_date and end_date (inclusive). Journal entries that become orphaned are deleted along with their line entries, and for businesses still backed by the legacy Teal engine the matching Teal transactions and journal entries are removed remotely as well. This action is irreversible.

Operation ID: delete_transactions_by_date_range_api_v1_transactions_by_date_range_delete·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Query

start_datestring · daterequired: Inclusive start date (YYYY-MM-DD). Transactions on or after this date are deleted.
end_datestring · daterequired: Inclusive end date (YYYY-MM-DD). Transactions on or before this date are deleted.
ledger_idstring: Optional ledger ID to restrict the deletion to a single bank account.

Responses

200Successful Response

Schema: SuccessEnvelope_TransactionDateRangeDeleteResponse_

successboolean
messagestring
codestring
dataTransactionDateRangeDeleteResponse

400Bad Request - Invalid input

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found - Resource does not exist

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError

5 fields

locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject

Code samples

DELETE/api/v1/transactions/by-date-range

bash

curl -X DELETE 'https://api.ondayzero.com/api/v1/transactions/by-date-range' \
  -H 'Authorization: Bearer dz_your_token' \
  -H 'x-business-id: YOUR_BUSINESS_ID'