---
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`

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

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/revisions/f86d2bdbcb08/schema)