---
title: "List bank-feed accounts and one transaction bucket"
method: GET
path: "/bank-feeds"
tags: ["Bank Feeds"]
---

# List bank-feed accounts and one transaction bucket

`GET /bank-feeds`

## Request

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

Returns one feed card per account with a live Bank Feeds card (connection is bank or files; bank rows and CSV upload rows share the table), hiddenFeeds for hidden cards, complete bucket counts, and a transaction page for the selected account. feed.balanceOnly is true when the bank finished loading history and reports a balance but has sent no transactions; upload a CSV for that account's rows. Account, transaction bucket, inclusive dates, and search are applied before pagination. Results are ordered newest first with transaction ID as a stable tie-breaker. Each row reports origin (bank or csv) and duplicatePartner when it has a live possible-duplicate partner.

## Query parameters

- `bankAccountId` string, uuid
- `transactionView` 'ready' | 'pending' | 'checks' | 'posted' | 'excluded' | 'all'
- `startDate` string, date
- `endDate` string, date
- `search` string
- `direction` 'in' | 'out'
- `sortBy` 'date' | 'amount'
- `sortOrder` 'asc' | 'desc'
- `selectIds` boolean
- `similarTo` string, uuid
- `page` integer
- `limit` integer
- `includeExcluded` boolean
- `sourceType` string
- `possibleDuplicate` boolean

## Response `200`

Feed cards, selected bucket rows, summary, diagnostics, and pagination with page, limit, total matching rows, and totalPages. An out-of-range page returns the last available page. Each feed card's repeatsRegister is null, or names another importing feed card that holds the same date and amount for most of this card's last 120 days of feed activity (bankAccountId, accountName, accountNumber, matchedCount, rowCount); importing both counts those charges twice.

## 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)