---
title: "Changes to List settlements"
method: GET
path: "/v2/settlements"
---

# Changes to List settlements

`GET /v2/settlements`

> Every recorded change to this endpoint, newest first.
> 79 revisions in range; 9 not diffed.

## Timeline

Changed in 9 of 79 revisions.

- **2026-08-18** `cc776d6ba83e` — 16 warning, 4 info
- **2026-08-07** `e1a1ad379a1e` — 7 breaking, 5 warning, 1 info
- **2026-07-30** `160fcdd65af7` — 2 warning
- **2026-07-08** `1bcb76dbe9ea` — 1 breaking
- **2026-07-02** `01ff4e7355c4` — 1 info
- **2026-07-02** `226f9009e928` — 2 warning
- **2026-05-19** `7cab62b21830` — 1 info
- **2026-05-12** `ef4b5a97b56a` — 2 info
- **2026-05-07** `36c56b46f150` — 1 warning

## Changes

- **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`
  - added the new `capture` 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 `capture` 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 `chargeback` 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 `chargeback` 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 `kickback` 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 `kickback` 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 `refund` 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 `refund` 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 `rollingreserve` 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 `rollingreserve` 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 `shiftedfee` 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 `shiftedfee` 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`
  - removed the `applepay` enum value from the `_embedded/settlements/items/allOf[#/components/schemas/entity-settlement-base]/periods/additionalProperties/additionalProperties/costs/items/method` response property for the response status `200`
  - removed the `applepay` enum value from the `_embedded/settlements/items/allOf[#/components/schemas/entity-settlement-base]/periods/additionalProperties/additionalProperties/revenue/items/method` response property for the response status `200`
  - removed the `googlepay` enum value from the `_embedded/settlements/items/allOf[#/components/schemas/entity-settlement-base]/periods/additionalProperties/additionalProperties/costs/items/method` response property for the response status `200`
  - removed the `googlepay` enum value from the `_embedded/settlements/items/allOf[#/components/schemas/entity-settlement-base]/periods/additionalProperties/additionalProperties/revenue/items/method` response property for the response status `200`
- **2026-08-07** `e1a1ad379a1e` — 7 breaking, 5 warning, 1 info
  - the `_embedded/settlements/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `_embedded/settlements/items/_links` from the response with the `200` status
  - removed the required property `_embedded/settlements/items/amount` from the response with the `200` status
  - removed the required property `_embedded/settlements/items/balanceId` from the response with the `200` status
  - removed the required property `_embedded/settlements/items/id` from the response with the `200` status
  - removed the required property `_embedded/settlements/items/resource` from the response with the `200` status
  - removed the required property `_embedded/settlements/items/status` from the response with the `200` status
  - removed the optional property `_embedded/settlements/items/createdAt` from the response with the `200` status
  - removed the optional property `_embedded/settlements/items/invoiceId` from the response with the `200` status
  - removed the optional property `_embedded/settlements/items/periods` from the response with the `200` status
  - removed the optional property `_embedded/settlements/items/reference` from the response with the `200` status
  - removed the optional property `_embedded/settlements/items/settledAt` from the response with the `200` status
  - added `#/components/schemas/entity-settlement-base, subschema #2` to the `_embedded/settlements/items/` response property `allOf` list for the response status `200`
- **2026-07-30** `160fcdd65af7` — 2 warning
  - added the new `billink` enum value to the `_embedded/settlements/items/periods/additionalProperties/additionalProperties/costs/items/method` response property for the response status `200`
  - added the new `billink` enum value to the `_embedded/settlements/items/periods/additionalProperties/additionalProperties/revenue/items/method` response property for the response status `200`
- **2026-07-08** `1bcb76dbe9ea` — 1 breaking
  - the `count` response property's min was decreased from `1.00` to `0.00` for the response status `200`
- **2026-07-02** `01ff4e7355c4` — 1 info
  - added the new enum value `RON` to the `query` request parameter `currencies`
- **2026-07-02** `226f9009e928` — 2 warning
  - added the new `undefined` enum value to the `_embedded/settlements/items/periods/additionalProperties/additionalProperties/costs/items/method` response property for the response status `200`
  - added the new `undefined` enum value to the `_embedded/settlements/items/periods/additionalProperties/additionalProperties/revenue/items/method` response property for the response status `200`
- **2026-05-19** `7cab62b21830` — 1 info
  - added the non-success response with the status `429`
- **2026-05-12** `ef4b5a97b56a` — 2 info
  - the endpoint scheme security `advancedAccessToken` was added to the API
  - the endpoint scheme security `organizationAccessToken` was removed from the API
- **2026-05-07** `36c56b46f150` — 1 warning
  - added the new `processing-at-bank` enum value to the `_embedded/settlements/items/status/allOf[#/components/schemas/settlement-status]/` response property for the response status `200`

---

[Operation](https://skmtc.dev/mollie/apis/mollie-api/docs/v2/settlements/get.md) · [API](https://skmtc.dev/mollie/apis/mollie-api.md) · [Page](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/settlements/get)