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

# Changes to List all refunds

`GET /v2/refunds`

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

## Timeline

Changed in 6 of 79 revisions.

- **2026-08-31** `eca80d9f3972` — 10 breaking, 3 warning, 3 info
- **2026-07-08** `1bcb76dbe9ea` — 1 breaking
- **2026-06-15** `5e44242e94d3` — 1 info
- **2026-05-19** `7cab62b21830` — 1 info
- **2026-05-12** `ef4b5a97b56a` — 2 info
- **2026-05-04** `18e0e58eb54d` — 1 info

## Changes

- **2026-08-31** `eca80d9f3972` — 10 breaking, 3 warning, 3 info
  - removed the required property `_embedded/refunds/items/_links` from the response with the `200` status
  - removed the required property `_embedded/refunds/items/amount` from the response with the `200` status
  - removed the required property `_embedded/refunds/items/createdAt` from the response with the `200` status
  - removed the required property `_embedded/refunds/items/description` from the response with the `200` status
  - removed the required property `_embedded/refunds/items/id` from the response with the `200` status
  - removed the required property `_embedded/refunds/items/metadata` from the response with the `200` status
  - removed the required property `_embedded/refunds/items/mode` from the response with the `200` status
  - removed the required property `_embedded/refunds/items/paymentId` from the response with the `200` status
  - removed the required property `_embedded/refunds/items/resource` from the response with the `200` status
  - removed the required property `_embedded/refunds/items/status` from the response with the `200` status
  - removed the optional property `_embedded/refunds/items/externalReference` from the response with the `200` status
  - removed the optional property `_embedded/refunds/items/routingReversals` from the response with the `200` status
  - removed the optional property `_embedded/refunds/items/settlementId` from the response with the `200` status
  - removed the optional write-only property `_embedded/refunds/items/reverseRouting` from the response with the `200` status
  - removed the optional write-only property `_embedded/refunds/items/testmode` from the response with the `200` status
  - added `#/components/schemas/list-entity-refund` to the `_embedded/refunds/items/` response property `allOf` list 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-06-15** `5e44242e94d3` — 1 info
  - the response property `_embedded/refunds/items/paymentId` became required for the 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-04** `18e0e58eb54d` — 1 info
  - response property `_embedded/refunds/items/settlementAmount` deprecated

---

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