Batch invert transaction amounts

POST /api/v1/transactions/batch/invert-amounts

Invert the sign of transaction amounts for multiple transactions. Useful for fixing bank accounts with inverted sign conventions. Also updates the source account setting to remember this preference for future syncs.

Operation ID: invert_transactions_amounts_api_v1_transactions_batch_invert_amounts_post · View as markdown · OpenAPI slice

Responses

201 Successful Response

Schema: TransactionListResponse

items array · TransactionListItemResponse requiredTransactionListItemResponse

List of items

29 fields

id string required: Unique identifier (UUID7).
amount integer required: Amount in cents. Positive = deposit/income, negative = withdrawal/expense.
currency string: Currency code (USD, CAD, AUD, EUR, or GBP).
datetime string · date required: The date the transaction occurred.
counterparty string: Clean counterparty/merchant name extracted from bank data.
description string: Transaction memo/description (cleaned).
meta object: Additional metadata (raw Plaid description in raw_plaid_description).
categorization_method string: How categorized: 'manual', 'rule', 'ai', or null if uncategorized.
posted_status string: Bank status: 'pending' or 'posted'.
review_status string: Review status: 'unreviewed', 'reviewed', 'flagged'.
source string: Transaction origin: 'manual', 'plaid', or 'bulk_upload'. Determines if the transaction can be deleted.
opposing_line_entry_ids array · string: Linked line entry UUIDs for categorization.
personal boolean: True if marked as personal (non-business) expense.
journal_entry_id string: Linked journal entry UUID.
teal_id string: External Teal accounting system ID.
teal_ledger_id string: Teal ledger ID.
teal_source_account_id string: Teal source account ID.
ledger_id string: Bank account (ledger) UUID.
ledger_name string: Bank account (ledger) name for display.
ledger_type string: Ledger account type: asset, liability, equity, revenue, or expense.
business_id string: Business UUID.
reconciled boolean: True if reconciled with bank statement.
invoice_ids array · string: Invoice UUIDs linked via payments (from invoice_payments junction table).
bill_ids array · string: Bill UUIDs linked via payments (from bill_payments junction table).
created_at string · date-time: Record creation timestamp.
updated_at string · date-time: Last update timestamp.
comment_count integer: Number of comments on this transaction.
journal_entry JournalEntryResponse: Full journal entry details if categorized.
opposing_line_entries array · OpposingLineEntryResponse: Opposing line entries showing the category/account(s) this transaction was posted to. Empty if uncategorized.

total integer

Total number of items (null when not calculated for performance)

limit integer

Pagination limit

next_cursor string

Cursor for next page

prev_cursor string

Cursor for previous page

has_next boolean required

Whether there are more items

has_prev boolean required

Whether there are previous items

400 Bad Request - Invalid input

401 Unauthorized - Authentication required

403 Forbidden - Insufficient permissions

404 Not Found - Resource does not exist

422 Validation Error

Schema: HTTPValidationError

detail array · ValidationError ValidationError

5 fields

loc array · string | integer required
msg string required
type string required
input object
ctx object

curl -X POST 'https://api.ondayzero.com/api/v1/transactions/batch/invert-amounts' \ -H 'Authorization: Bearer dz_your_token' \ -H 'x-business-id: YOUR_BUSINESS_ID' \ -H 'Content-Type: application/json' \ -d '{ "transaction_ids": [] }'