---
title: "List statements"
method: GET
path: "/v2/statements"
tags: ["Statements"]
---

# List statements

`GET /v2/statements`

## Request

- Base URL: `https://thirdparty.qonto.com`
- URL: `https://thirdparty.qonto.com/v2/statements`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://oauth.qonto.com/oauth2/auth`
    - Token URL: `https://oauth.qonto.com/oauth2/token` scopes: `organization.read`
  - API key in header `Authorization`

OAuth scope: `organization.read`

---
Retrieves the list of statements for the authenticated organization.

## Query parameters

- `bank_account_ids[]` unknown[]
  - unknown
- `ibans[]` unknown[]
  - unknown
- `period_from` string
- `period_to` string
- `page` integer
- `per_page` integer
- `sort_by` string

## Headers

- `X-Qonto-Staging-Token` string

## Response `200`

Returns the list of statements of the authentified organization.

- object
  - `statements` Statement[]
    - `id` string, required: Unique identifier of the statement.
    - `bank_account_id` string, required: Unique identifier of the bank account associated to the statement.
    - `period` string, required: Month of the statement with the `MM-YYYY` format.
    - `file` object, required
      - `file_name` string, required: Name of the statement file
      - `file_content_type` string, required: Type of the statement file
      - `file_size` string, required: Size of the statement file
      - `file_url` string, required: Link to downlaod the statement file. **The url expires after 30 minutes**.
  - `meta` Pagination
    - `current_page` integer
    - `next_page` integer, nullable
    - `prev_page` integer, nullable
    - `total_pages` integer
    - `total_count` integer
    - `per_page` integer

## Other responses

- `422`: Returns errors.

## Changes

- **2025-01-24** (v2) `25208d6f9deb`: 2 breaking
  - the `meta/next_page` response's property type changed from no type to `integer` for status `200`
  - the `meta/prev_page` response's property type changed from no type to `integer` for status `200`

[Operation history](https://skmtc.dev/hiit-consulting-fr/apis/qonto/changes/v2/statements/get.md)

---

[API](https://skmtc.dev/hiit-consulting-fr/apis/qonto.md) - [All operations](https://skmtc.dev/hiit-consulting-fr/apis/qonto/llms.txt) - [OpenAPI document](https://skmtc.dev/hiit-consulting-fr/apis/qonto/revisions/25208d6f9deb?raw)