Get Transactions
Get bank transactions across all connected accounts (v2, ClickHouse-backed).
Returns transactions within the specified date range from all linked bank accounts. Reads from ClickHouse instead of Core API for improved performance. Supports pagination, category/type/account/amount/merchant filtering, and sorting.
The daily_totals array in the response reflects the same active filters.
When transaction_type=DEBIT is applied, all daily net totals will be negative
(debits only, no credits to offset them) — this is intentional and arithmetically consistent.
Authorizations
Bearer authentication with a personal access token (prefix pat_). Generate tokens in the Truv web app under Settings → API keys.
Query Parameters
Start date for the transaction window (inclusive, YYYY-MM-DD).
"2025-01-01"
End date for the transaction window (inclusive, YYYY-MM-DD). Defaults to today.
"2025-12-31"
Comma-separated category slugs to include (e.g. 'income,transfer'). Omit to include all categories.
1000"income,transfer"
Filter by transaction type. Omit to include both debits and credits.
DEBIT, CREDIT "DEBIT"
Comma-separated account IDs to include. Omit to include all accounts.
"acc_001,acc_002"
Minimum transaction amount (absolute value). Inclusive.
"10.00"
Maximum transaction amount (absolute value). Inclusive.
"500.00"
Case-insensitive substring match on merchant name or description.
"starbucks"
Comma-separated category slugs to exclude (e.g. 'transfer,uncategorized').
1000Sort transactions by date or absolute amount.
date, amount "date"
Sort direction: ascending or descending.
asc, desc "desc"
1-based page number, defaulting to 1 when paginating. Pagination is off unless page or page_size is set; with neither set, all matching transactions are returned in one response.
x >= 11
Transactions per page (min 10, max 500), defaulting to 500 when paginating. Pagination is off unless page or page_size is set; with neither set, all matching transactions are returned in one response.
10 <= x <= 500100
Include user-hidden transactions alongside visible ones. Hidden transactions can be unhidden; permanently deleted transactions are never returned regardless.
true