---
title: "List bank transactions across organization bank accounts"
method: GET
path: "/bank-transactions"
tags: ["Banking"]
---

# List bank transactions across organization bank accounts

`GET /bank-transactions`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/bank-transactions`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Returns organization-scoped bank transaction history with text search, inclusive dates, and pagination. Filters apply before paging. Excluded rows are hidden by default; request status=excluded, transactionView=excluded, or includeExcluded=true for excluded history. Amounts are signed integer cents. Each row's pending is true while the bank reports it pending or while a card payment waits for its matching side (the Bank Feeds Pending rule).

## Query parameters

- `bankAccountId` string, uuid
- `status` 'unreconciled' | 'reconciled' | 'excluded'
- `includeExcluded` boolean
- `sourceType` string
- `startDate` string, date
- `endDate` string, date
- `limit` integer
- `search` string
- `direction` 'in' | 'out'
- `page` integer
- `transactionView` 'all' | 'ready' | 'pending' | 'checks' | 'posted' | 'excluded'
- `activeFeedOnly` boolean

## Response `200`

Bank transactions

- object
  - `data` BankTransaction[]
    - `id` string, uuid
    - `bankAccountId` string, uuid
    - `date` string, date
    - `postedDate` string, date, nullable
    - `description` string
    - `reference` string, nullable
    - `amount` integer: Integer cents. Example: 1250 means $12.50.
    - `balance` integer, nullable
    - `status` 'unreconciled' | 'reconciled' | 'excluded'
    - `sourceType` string: Plaid imports use plaid_bank_feed.
    - `externalTransactionId` string, nullable
    - `accountId` string, uuid, nullable
    - `suggestionCoded` boolean
    - `suggestionSource` 'phonebook' | 'taxonomy' | 'history' | 'ai' | 'null', nullable
    - `suggestionBasis` string, nullable
    - `suggestionConfidence` number, nullable
    - `suggestionRationale` string, nullable
    - `contactId` string, uuid, nullable
    - `taxRateId` string, uuid, nullable
    - `journalEntryId` string, uuid, nullable
  - `transactions` BankTransaction[]
    - `id` string, uuid
    - `bankAccountId` string, uuid
    - `date` string, date
    - `postedDate` string, date, nullable
    - `description` string
    - `reference` string, nullable
    - `amount` integer: Integer cents. Example: 1250 means $12.50.
    - `balance` integer, nullable
    - `status` 'unreconciled' | 'reconciled' | 'excluded'
    - `sourceType` string: Plaid imports use plaid_bank_feed.
    - `externalTransactionId` string, nullable
    - `accountId` string, uuid, nullable
    - `suggestionCoded` boolean
    - `suggestionSource` 'phonebook' | 'taxonomy' | 'history' | 'ai' | 'null', nullable
    - `suggestionBasis` string, nullable
    - `suggestionConfidence` number, nullable
    - `suggestionRationale` string, nullable
    - `contactId` string, uuid, nullable
    - `taxRateId` string, uuid, nullable
    - `journalEntryId` string, uuid, nullable
  - `bankTransactions` BankTransaction[]
    - `id` string, uuid
    - `bankAccountId` string, uuid
    - `date` string, date
    - `postedDate` string, date, nullable
    - `description` string
    - `reference` string, nullable
    - `amount` integer: Integer cents. Example: 1250 means $12.50.
    - `balance` integer, nullable
    - `status` 'unreconciled' | 'reconciled' | 'excluded'
    - `sourceType` string: Plaid imports use plaid_bank_feed.
    - `externalTransactionId` string, nullable
    - `accountId` string, uuid, nullable
    - `suggestionCoded` boolean
    - `suggestionSource` 'phonebook' | 'taxonomy' | 'history' | 'ai' | 'null', nullable
    - `suggestionBasis` string, nullable
    - `suggestionConfidence` number, nullable
    - `suggestionRationale` string, nullable
    - `contactId` string, uuid, nullable
    - `taxRateId` string, uuid, nullable
    - `journalEntryId` string, uuid, nullable
  - `count` integer
  - `pagination` object
    - `page` integer
    - `limit` integer
    - `total` integer
    - `totalPages` integer

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)