Bank Transactions
List bank lines
Credential: a company's API key or OAuth token.
The bank lines on the company’s bank accounts, newest booking first, with each line’s reconciliation and dismissal state. Lines on a deleted bank account are left out; lines on a disabled one are included.
Filter by bankAccountId, by booking date (bookingDateFrom / bookingDateTo, both inclusive), by signed
amount (bankAccountAmountMin / bankAccountAmountMax) and by status. Sort by bookingDate or
bankAccountAmount. Page with cursor: pass the previous response’s nextCursor with the same filters and
sort.
Required Scope
bank-transactions-read
query Parameters
cursorOpaque cursor from the previous response's nextCursor. Returns the rows after it, in the same order. Send the same filters and sort as the request that produced it, and do not send page. The preferred way to page through a list.
pageDeprecated: page with cursor instead. Page number (1-indexed). From 2026-12-31, a page past the first of a list with more than 10,000 matching rows is refused.
limitNumber of items per page
bankAccountIdOnly lines on this bank account. A bank account of another company returns an empty list.
bookingDateFromOnly lines booked by the bank on or after this date (YYYY-MM-DD). Filters bookingDate.
bookingDateToOnly lines booked by the bank on or before this date (YYYY-MM-DD). Filters bookingDate.
bankAccountAmountMinOnly lines whose bankAccountAmount is at least this value. Amounts are signed: money out is negative, so bankAccountAmountMin=-500&bankAccountAmountMax=-100 selects payments of 100 to 500.
bankAccountAmountMaxOnly lines whose bankAccountAmount is at most this value. Signed, like the minimum.
statusOnly lines in this state: open (waiting to be reconciled), reconciled, or dismissed (taken off reconciliation). Omit for every line.
sortBySort field. Ties are broken by the line id, so a cursor walk never repeats or skips a line.
sortOrderSort direction
List bank lines › Responses
One page of bank lines
totalLines matching the query, across all pages.
limitItems per page
nextCursorCursor for the next page; pass it as cursor. null on the last page, and on every page of a sort that cannot page by cursor — hasMore then says whether another page follows by page number.
hasMoreWhether more rows follow this page.
pageDeprecated: page with nextCursor instead. Current page (1-indexed).
totalPagesDeprecated: page with nextCursor instead. Total pages.
Get a bank line
Credential: a company's API key or OAuth token.
One bank line, with what it is reconciled to when it is reconciled, and when it was dismissed when it is
dismissed. Answers 404 BANK_TRANSACTION_NOT_FOUND for a line of another company or on a deleted bank account.
Required Scope
bank-transactions-read
path Parameters
bankTransactionIdID of the bank line (UUID)
Get a bank line › Responses
The bank line
idbankAccountIdThe bank account the line is on.
bookingDateThe date the bank booked the line (YYYY-MM-DD).
valueDateThe date the money moved, as the bank reports it (YYYY-MM-DD).
bankAccountAmountThe amount in the bank account's currency (bankAccountCurrency). Negative for money out, positive for money in.
bankAccountCurrencyThe bank account's currency, which bankAccountAmount is in.
originalAmountThe amount in the currency the payment was made in, when the bank reports one, such as a card purchase abroad. In originalCurrency, with the sign of bankAccountAmount; on a line whose bankAccountAmount is 0 it is the figure as the bank sent it, which may carry either sign. Null when the bank reports none.
originalCurrencyoriginalExchangeRateThe rate the bank converted at, as it reports it. Null when it reports none.
directionWhich way the money went. Null on a zero-amount line.
descriptionThe line text.
bankTextThe bank's own text for the line, when it sends one apart from description.
referencepaymentMessageThe message the payer sent with the payment.
fikThe payment slip (FIK) the line was paid with. Null when the line carries none.
statusreconciliationWhat the line is reconciled to. Null unless status is reconciled.
dismissedAtWhen the line was taken off reconciliation (ISO 8601). Null unless status is dismissed, and null on a dismissed line whose dismissal time was not recorded.
createdAtWhen the line was recorded in LedgerBee (ISO 8601).
Dismiss bank lines from reconciliation
Credential: a company's API key or OAuth token.
Takes the lines off reconciliation, as the bank page’s dismiss does: they need no match, typically because the bank feed delivered the same payment twice. Nothing is posted to the books. A reconciled line is left alone; undo its reconciliation first. Each line’s row says whether it was changed.
Undo it with POST /v1/bank-transactions/undismiss.
Required Scope
bank-reconciliations-write
Headers
x-api-idempotency-keyOptional idempotency key for safely retrying mutating requests.
Dismiss bank lines from reconciliation › Request Body
bankTransactionIdsThe bank lines to dismiss from reconciliation, or to restore to it, at most 50.
Dismiss bank lines from reconciliation › Responses
One row per line: changed, or the code it was left alone with.
changedCountunchangedCountOne row per line, in request order.
Check which bank lines a dismiss would change
Credential: a company's API key or OAuth token.
Reports per line whether dismissing it would take it off reconciliation, or why not: not found, reconciled (undo the reconciliation first), or already dismissed. Nothing is changed.
Answers 400 BANK_DISMISS_NOTHING_ELIGIBLE, with the rows in details.results, when no line would change.
Required Scope
bank-reconciliations-write
Headers
x-api-idempotency-keyOptional idempotency key for safely retrying mutating requests.
Check which bank lines a dismiss would change › Request Body
bankTransactionIdsThe bank lines to dismiss from reconciliation, or to restore to it, at most 50.
Check which bank lines a dismiss would change › Responses
What the dismiss would change. Nothing was changed.
eligibleCountLines the call would change.
ineligibleCountLines the call would leave as they are.
One row per line, in request order.
Restore dismissed bank lines to reconciliation
Credential: a company's API key or OAuth token.
Puts dismissed lines back on reconciliation, so they can be matched again. Nothing is posted to the books. Each line’s row says whether it was changed.
Required Scope
bank-reconciliations-write
Headers
x-api-idempotency-keyOptional idempotency key for safely retrying mutating requests.
Restore dismissed bank lines to reconciliation › Request Body
bankTransactionIdsThe bank lines to dismiss from reconciliation, or to restore to it, at most 50.
Restore dismissed bank lines to reconciliation › Responses
One row per line: changed, or the code it was left alone with.
changedCountunchangedCountOne row per line, in request order.
Check which bank lines a restore would change
Credential: a company's API key or OAuth token.
Reports per line whether restoring it would put it back on reconciliation, or why not: not found, or not dismissed. Nothing is changed.
Answers 400 BANK_DISMISS_NOTHING_ELIGIBLE, with the rows in details.results, when no line would change.
Required Scope
bank-reconciliations-write
Headers
x-api-idempotency-keyOptional idempotency key for safely retrying mutating requests.
Check which bank lines a restore would change › Request Body
bankTransactionIdsThe bank lines to dismiss from reconciliation, or to restore to it, at most 50.
Check which bank lines a restore would change › Responses
What the restore would change. Nothing was changed.
eligibleCountLines the call would change.
ineligibleCountLines the call would leave as they are.
One row per line, in request order.