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

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

---

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