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

# Search Statements

`GET /business/v2/statements`

## Request

- Base URL: `https://api.soldo.com`
- URL: `https://api.soldo.com/business/v2/statements`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.soldo.com/oauth/authorize` scopes: `statement_read`
- TypeScript: <https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/docs/business/v2/statements/get.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint to find `Statements` available for download using filtering parameters.

## Query parameters

- `year` integer[], required: The year to search for `Statements`.
- `currency` 'EUR' | 'GBP' | 'USD', required: The [ISO 4217](https://www.six-group.com/en/products-services/financial-information/data-standards.html#scrollTo=maintenance-agency) code of the currency of the `Statement` to search for.

## Response `200`

The result array contains `Statements` available for download.

- Statements
  - `total` integer: It represents the total number of available items in the list.
  - `results` Statement[]
    - `year` integer: The reference year for `Statement`.
    - `month` 'JANUARY' | 'FEBRUARY' | 'MARCH' | 'APRIL' | 'MAY' | 'JUNE' | 'JULY' | 'AUGUST' | 'SEPTEMBER' | 'OCTOBER' | 'NOVEMBER' | 'DECEMBER'
    - `currency` 'EUR' | 'GBP' | 'USD': The [ISO 4217](https://www.six-group.com/en/products-services/financial-information/data-standards.html#scrollTo=maintenance-agency) code of the currency of the `Statement` to search for.
    - `file_types` string[]: The generated `Statement` file types.

## Other responses

- `400`: Your request has missing arguments or is malformed.

---

[API](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0.md) - [All operations](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/revisions/23fc5d07b367?raw)