---
title: "List transactions for a bank account (money in / money out). Currently supported only for refund accounts; other roles return 404. Supports JSON (paginated) and xlsx/csv exports via Accept header."
method: GET
path: "/api/v1/bank-accounts/{bankAccountId}/transactions"
tags: ["Merchant Bank Accounts"]
---

# List transactions for a bank account (money in / money out). Currently supported only for refund accounts; other roles return 404. Supports JSON (paginated) and xlsx/csv exports via Accept header.

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

## Request

- Base URL: `https://core.quidkey.com`
- URL: `https://core.quidkey.com/api/v1/bank-accounts/{bankAccountId}/transactions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/banqzinc/apis/quidkey-api/docs/api/v1/bank-accounts/:bankAccountId/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

List transactions for a bank account (money in / money out). Currently supported only for refund accounts; other roles return 404. Supports JSON (paginated) and xlsx/csv exports via Accept header.

## Path parameters

- `bankAccountId` string, uuid, required: Bank account ID

## Query parameters

- `date_from` string, date: Filter from date (ISO 8601 YYYY-MM-DD)
- `date_to` string, date: Filter to date (ISO 8601 YYYY-MM-DD)
- `page` integer: Page number (1-based)
- `limit` union: Rows per page (provider-limited)
  - 10
  - 20
  - 50
  - 100
- `direction` union: Filter to money in or money out only. Omit for both.
  - 'in'
  - 'out'

## Response `200`

Success

- BankAccountTransactionsListResponse
  - `success` boolean, required: Indicates if the request was successful
  - `data` object[], required
    - `date` string, required: Transaction date (ISO 8601)
    - `direction` union, required: Whether money moved into ("in") or out of ("out") the account
      - 'in'
      - 'out'
    - `amount` string, required: Absolute amount as a decimal string in the account currency
    - `currency` string, required: ISO 4217 currency code
    - `beneficiary` string, required: For Money In: the merchant the account belongs to. For Money Out: the customer being refunded (resolved via the linked Quidkey transaction).
    - `running_balance` string, required: Running balance after this entry (decimal string)
    - `transaction_type` string, required: Provider transaction type (Wire, ACH, ...)
    - `status` string, required: Provider-reported status
    - `web_transaction_id` string, required: Provider transaction id
    - `related_transaction_id` string: Linked Quidkey Transaction id (for money-out rows)
    - `related_transaction_number` string: Linked Quidkey Transaction.transaction_number for deep-link
  - `pagination` object, required: Metadata for paginated responses
    - `total` integer, required: Total number of items
    - `page` integer, required: Current page number
    - `limit` integer, required: Number of items per page
    - `totalPages` integer, required: Total number of pages
    - `hasNextPage` boolean, required: Whether there is a next page
    - `hasPreviousPage` boolean, required: Whether there is a previous page

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `502`: Response

## Changes

- **2026-06-17** `b372e7d5563d`: 1 info
  - endpoint added
- **2025-11-02** `919eb7a392aa`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/banqzinc/apis/quidkey-api/changes/api/v1/bank-accounts/:bankAccountId/transactions/get.md)

---

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