---
title: "List transactions"
method: GET
path: "/v0/bank/accounts/{bank-account-id}/transactions"
tags: ["Transactions"]
---

# List transactions

`GET /v0/bank/accounts/{bank-account-id}/transactions`

## Request

- Base URL: `https://api.griffin.com`
- URL: `https://api.griffin.com/v0/bank/accounts/{bank-account-id}/transactions`
- Auth: API key in header `Authorization`

Lists transactions on a bank account. Use an `Accept: application/vnd.griffin+xero-csv` header to receive transactions in a CSV format suitable for importing into [Xero](https://central.xero.com/s/article/Import-a-CSV-bank-statement).

## Path parameters

- `bank-account-id` string, required

## Query parameters

- `sort` '-created-at' | 'processed-at' | '-processed-at' | 'created-at'
- `page[size]` integer
- `page[before]` string, byte
- `page[after]` string, byte
- `include` 'payment'
- `filter[processed-at][lte]` string, date-time
- `filter[processed-at][lt]` string, date-time
- `filter[processed-at][gte]` string, date-time
- `filter[processed-at][gt]` string, date-time

## Response `200`

OK

- object
  - `account-transactions` object[], required
    - `account-transaction-url` union, required: Link to the transaction resource.
      - string
      - string
    - `processed-at` string, date-time, required: When the transaction was entered into the account ledger.
    - `post-datetime` string, date-time: Deprecated. Please use `processed-at` instead.
    - `balance-change-direction` 'credit' | 'debit', required: Specifies the direction of a balance change.
    - `origin-metadata` object: Identifiers from the system that originated the hold or transaction. Keys and values are originator-specific.
    - `effective-at` string, date-time, required: When the transaction actually takes effect on the account balance.
    - `transaction-origin-type` 'interest' | 'deposit' | 'manual-payment' | 'card-transaction' | 'fee' | 'transfer' | 'payment' | 'commission', required: Indicates the source of the transaction. For a description of each origin type, see our guide to [transactions](/docs/guides/transactions).
    - `payment-url` string: Link to the payment resource.
    - `reference` string: This field is provided by the person or entity who made the payment.
    - `account-url` union, required: Link to the bank account resource.
      - string
      - string
    - `balance-change` object, required: Shows the account [balance change](/docs/terms/balance-change).
      - `currency` 'GBP', required
      - `value` string, required: The value as a decimal-formatted string
    - `account-balance` object, required: Shows the [account balance](/docs/terms/account-balance).
      - `currency` 'GBP', required
      - `value` string, required: The value as a decimal-formatted string
    - `description` string: This field is provided by the bank to help customers understand the nature of the transaction.
  - `links` object, required
    - `prev` string, nullable, required
    - `next` string, nullable, required
  - `included` unknown

## Other responses

- `400`: Bad Request
- `401`: Requires an API key to continue
- `404`: Not Found

## Changes

- **2026-09-19** `3e69d9e24ef6`: 1 info
  - api operation id `get-bank-accounts-bank-account-id-transactions` was added

[Operation history](https://skmtc.dev/griffin/apis/the-griffin-api/changes/v0/bank/accounts/:bank-account-id/transactions/get.md)

---

[API](https://skmtc.dev/griffin/apis/the-griffin-api.md) - [All operations](https://skmtc.dev/griffin/apis/the-griffin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/griffin/apis/the-griffin-api/revisions/9e4c303c70a5?raw)