---
title: "Get next settlement"
method: GET
path: "/v2/settlements/next"
tags: ["Settlements API"]
---

# Get next settlement

`GET /v2/settlements/next`

Retrieve the details of the current settlement, that has not yet been paid out.

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

For more accurate bookkeeping, refer to the [balance report](get-balance-report) endpoint or the
[balance transactions](list-balance-transactions) endpoint.

## Headers

- `idempotency-key` string

## Response `200`

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

## Other responses

- `429` — Rate Limit has been reached.

## Changes

> 79 revisions in range; 9 not diffed.

- **2026-08-18** `cc776d6ba83e` — 16 warning, 4 info
  - added the new `applicationfee` enum value to the `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 `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 `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 `allOf[#/components/schemas/entity-settlement-base]/periods/additionalProperties/additionalProperties/revenue/items/method` response property for the response status `200`
  - …16 more
- **2026-08-07** `e1a1ad379a1e` — 7 breaking, 5 warning, 1 info
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `_links` from the response with the `200` status
  - removed the required property `amount` from the response with the `200` status
  - removed the required property `balanceId` from the response with the `200` status
  - …9 more
- …earlier changes not shown

[Full history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/settlements/next/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/b7497b77b18f/schema)