---
title: "List bank transactions"
method: GET
path: "/api/v1/iqbooks/organisations/{organisationId}/bank-transactions"
tags: ["IQ Books — Bank"]
---

# List bank transactions

`GET /api/v1/iqbooks/organisations/{organisationId}/bank-transactions`

## Request

- Base URL: `https://api.reconcileiq.com`
- URL: `https://api.reconcileiq.com/api/v1/iqbooks/organisations/{organisationId}/bank-transactions`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Paginated list of bank transactions. Filters: `?status`, `?bank_account_id`, `?date_from`, `?date_to` (YYYY-MM-DD), plus `?limit`/`?offset`. Requires scope `iqbooks:read`.

## Path parameters

- `organisationId` integer, required

## Query parameters

- `limit` integer
- `offset` integer
- `status` string
- `bank_account_id` integer
- `date_from` string, date
- `date_to` string, date

## Response `200`

Bank transactions.

- object
  - `data` BankTransaction[], required
    - `id` integer
    - `organisation_id` integer
    - `bank_account_id` integer
    - `bank_account_name` string, nullable
    - `journal_entry_id` integer, nullable: Set once confirmed.
    - `transaction_date` string, date
    - `description` string
    - `direction` 'money_in' | 'money_out'
    - `amount` number: Decimal major units, positive.
    - `currency` string
    - `category_account_id` integer, nullable
    - `category_account_code` string, nullable
    - `category_account_name` string, nullable
    - `category_account_type` string, nullable
    - `vat_amount` number, nullable
    - `vat_code` string, nullable
    - `status` string: Lifecycle status. A newly created manual transaction is 'draft'; once confirmed it is 'confirmed'. May also be 'ignored'. Branch on 'draft' (not 'pending') for un-confirmed rows.
    - `entry_route` string, nullable
    - `reference` string, nullable
    - `created_at` string, date-time
    - `confirmed_at` string, date-time, nullable
  - `pagination` object, required
    - `limit` integer, required
    - `offset` integer, required
    - `count` integer, required: Number of rows in this page (data.length).
    - `total` integer: Total matching rows when the native service reports it; may be absent.

## Other responses

- `401`: Missing, invalid, or revoked API key.
- `403`: Authenticated but the key lacks the required scope.
- `404`: Resource not found, or not visible to the caller (no existence leak).
- `422`: CodeIQ / IQ Books strict-format contract violation.

---

[API](https://skmtc.dev/reconcileiq/apis/reconcileiq-public-api.md) · [All operations](https://skmtc.dev/reconcileiq/apis/reconcileiq-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reconcileiq/apis/reconcileiq-public-api/revisions/5401beef8653?raw)