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

# List settlements

`GET /settlements`

Retrieve a list of all your settlements.

The results are paginated.

> 🔑 Access with
>
> [Advanced access token with **settlements.read**](/reference/authentication)
>
> [OAuth access with **settlements.read**](/reference/authentication)

## Query parameters

- `from` string
- `limit` integer, nullable
- `balanceId` string, nullable
- `year` string, nullable
- `month` string, nullable
- `currencies` string, nullable

## 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.

---

[API](https://skmtc.net/mollie/apis/accepting-payments.md) · [All operations](https://skmtc.net/mollie/apis/accepting-payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mollie/accepting-payments/revisions/4b45df3039ef/schema)