---
title: "List settlements"
method: GET
path: "/v2/settlements"
tags: ["Settlements API"]
---

# List settlements

`GET /v2/settlements`

Retrieve a list of all your settlements.

The results are paginated.

## Query parameters

- `from` string, nullable
- `limit` integer, nullable
- `balanceId` string
- `year` string, nullable
- `month` string, nullable
- `currencies` 'EUR' | 'GBP' | 'CHF' | 'DKK' | 'NOK' | 'PLN' | 'SEK' | 'USD' | 'CZK' | 'HUF' | 'AUD' | 'CAD' | 'RON'

## Headers

- `idempotency-key` string

## Response `200`

A list of settlement objects. For a complete reference of the settlement
object, refer to the [Get settlement endpoint](get-settlement) documentation.

## Other responses

- `400` — The request contains issues. For example, if the specified `from` value is not a valid ID.
- `404` — No entity with this ID exists.
- `429` — Rate Limit has been reached.

## Changes

> 78 revisions in range; 9 not diffed.

- **2026-08-18** `cc776d6ba83e` — 16 warning, 4 info
  - added the new `applicationfee` enum value to the `_embedded/settlements/items/allOf[#/components/schemas/entity-settlement-base]/periods/additionalProperties/additionalProperties/costs/items/method` response property for the response status `200`
  - added the new `applicationfee` enum value to the `_embedded/settlements/items/allOf[#/components/schemas/entity-settlement-base]/periods/additionalProperties/additionalProperties/revenue/items/method` response property for the response status `200`
  - added the new `authorizationreversal` enum value to the `_embedded/settlements/items/allOf[#/components/schemas/entity-settlement-base]/periods/additionalProperties/additionalProperties/costs/items/method` response property for the response status `200`
  - added the new `authorizationreversal` enum value to the `_embedded/settlements/items/allOf[#/components/schemas/entity-settlement-base]/periods/additionalProperties/additionalProperties/revenue/items/method` response property for the response status `200`
  - …16 more
- …earlier changes not shown

[Full history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/settlements/get.md)

---

[API](https://skmtc.dev/mollie/apis/mollie-api.md) · [All operations](https://skmtc.dev/mollie/apis/mollie-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mollie/mollie-api/revisions/c7210fff5e59/schema)