Transactions
Your bank transactions, as they appear on your accounts — dates, amounts, counterparties, IBANs, card numbers — enriched with category names.
A transaction that was split into pieces (per-category, per-receipt)
has is_split: true and carries the pieces in children. The pieces
always add up to the transaction amount — so when you sum amounts,
sum only the transactions themselves; the children are a breakdown,
not additional money.
List bank transactions
Newest first. Filter by date range, direction, or bank account.
query Parameters
date_fromInclusive lower bound on transaction_date.
date_toInclusive upper bound on transaction_date.
typeincoming = amount > 0; outgoing = amount < 0.
bank_account_idOnly transactions of one bank account — pass the account's id
from GET /bank-accounts. (Transaction rows show the account by
name in bank_account.)
cursorThe next_cursor value from the previous response, exactly as received. Leave out for the first page.
limitPage size. Values outside 1–1000 fail with 400.
List bank transactions › Responses
One page of transactions.
next_cursorPass as cursor to get the next page; null when there are no more pages.
Get one transaction
Works with any transaction id you got from the API — including a
transaction_id from an expense's payments. If that id belongs to a
piece of a split transaction, you get the full transaction with the
piece inside children, so you always see the complete bank movement.
path Parameters
idA transaction id, e.g. from the list endpoint or an expense payment's transaction_id.
Get one transaction › Responses
The transaction.
idUnique, permanent id. A random string — use it exactly as returned.
company_keybank_accountName of the bank account ("unnamed" if the account has no name; null if the transaction isn't tied to an account).
transaction_dateThe date the money moved, per your bank.
amountNegative = money out, positive = money in. In currency.
currencyamount_eurThe amount in EUR (2 decimals) — use this when summing across currencies.
exchange_rateEUR per unit of currency; null when not known.
titledescriptionreferencepayer_titlereceiver_titlepayer_ibanreceiver_ibanpayment_cardMasked card number when this was paid by card.
An id + name pair, e.g. a category or partner. Both null when not set.
An id + name pair, e.g. a category or partner. Both null when not set.
is_splitTrue when the transaction is split into pieces (see children).
The pieces of a split transaction; empty for normal transactions.