---
title: "List bank transactions"
method: GET
path: "/v1/bank-accounts/{bankAccountId}/bank-transactions"
tags: ["v1 - Bank Accounts"]
---

# List bank transactions

`GET /v1/bank-accounts/{bankAccountId}/bank-transactions`

## Request

- Base URL: `https://light.inc` (the document declares no server; this is the origin it was published from)
- URL: `https://light.inc/v1/bank-accounts/{bankAccountId}/bank-transactions`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

Returns a paginated list of bank transactions for the specified bank account, including the balance

## Path parameters

- `bankAccountId` string, uuid, required

## Query parameters

- `sort` string: Sort string in the format `field:direction`. To provide multiple sort fields, separate them with commas. Available directions: `asc`, `desc`. Available fields: `reconciliationStatus`, `dcSign`, `date`, `amount`, `name`, `memo`.
- `filter` string: Filter string in the format `field:operator:value`. To provide multiple filters, separate them with commas. Available operators: `eq`, `ne`, `in`, `not_in`, `gt`, `gte`, `lt`, `lte`. - For `in` and `not_in` operators, provide multiple values separated by the pipe character (`|`). Available fields: `reconciliationStatus`, `dcSign`, `date`.
- `limit` integer
- `offset` integer
- `cursor` string

## Response `default`

default response

- ExternalGetAllResponseWithBalanceV1ModelExternalBankTransactionV1Model
  - `total` integer
  - `records` ExternalBankTransactionV1Model[]
    - `id` string, uuid: Unique identifier for the bank transaction
    - `bankAccountId` string, uuid: ID of the bank account this transaction belongs to
    - `date` string, date: Transaction date
    - `amount` integer: Transaction amount in minor units (e.g. cents)
    - `dcSign` 'D' | 'C': Debit/credit sign ⚠️ This enum is not exhaustive; new values may be added in the future.
    - `reconciliationStatus` 'EXCLUDED' | 'MATCHED' | 'UNMATCHED': Reconciliation status ⚠️ This enum is not exhaustive; new values may be added in the future.
    - `name` string, nullable: Transaction name / payee
    - `memo` string, nullable: Transaction memo / description
    - `reference` string, nullable: Transaction reference
    - `transactionId` string, nullable: External transaction identifier for idempotency
    - `createdAt` string, date-time: Timestamp when the transaction was created
  - `balance` integer

---

[API](https://skmtc.dev/light/apis/light-api.md) - [All operations](https://skmtc.dev/light/apis/light-api/llms.txt) - [OpenAPI document](https://skmtc.dev/light/apis/light-api/revisions/84f51306f648?raw)