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

# List bank account statements

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

## Request

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

Lists the statements requested for a bank account.

Statements are returned most recently requested first.

## Path parameters

- `bank-account-id` string, required

## Query parameters

- `sort` '-created-at' | 'created-at'
- `page[size]` integer
- `page[after]` string, byte
- `page[before]` string, byte

## Response `200`

OK

- object: The statements requested for the bank account, a page at a time.
  - `statements` object[], required
    - `statement-url` union, required: Link to this statement.
      - string
      - string
    - `account-url` union, required: Link to the bank account resource.
      - string
      - string
    - `format` 'xero-csv' | 'griffin-pdf', required: The format of the statement's document.
    - `start-date` string, date, required: The first day covered by the statement, inclusive.
    - `end-date` string, date, required: The last day covered by the statement, inclusive.
    - `status` 'pending' | 'generated' | 'failed', required: `pending` while the document is being generated, then `generated` when it is ready to download.
    - `created-at` string, date-time, required: When the statement was requested.
    - `statement-download-url` union: Link to download the statement's document, once its `status` is `generated`. The response is the document itself, not JSON, in the statement's format.
      - string
      - string
  - `links` object, required
    - `prev` string, nullable, required
    - `next` string, nullable, required

## Other responses

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

## Changes

- **2026-10-01** `4ffbc4f3e4b6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/griffin/apis/the-griffin-api/changes/v0/bank/accounts/:bank-account-id/statements/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)