---
title: "List payment refunds"
method: GET
path: "/v2/payments/{paymentId}/refunds"
tags: ["Refunds API"]
---

# List payment refunds

`GET /v2/payments/{paymentId}/refunds`

Retrieve a list of all refunds created for a specific payment.

The results are paginated.

## Query parameters

- `from` string
- `limit` integer, nullable
- `embed` string, nullable
- `testmode` boolean

## Headers

- `idempotency-key` string

## Response `200`

A list of refund objects. For a complete reference of the refund object, refer to the
[Get refund endpoint](get-refund) 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

> 92 revisions in range; 9 not diffed.

- **2026-09-15** `26176035db58` — 1 breaking
  - the response property `_embedded/refunds/items/allOf[#/components/schemas/list-entity-refund]/description` became nullable for the status `200`
- **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
  - …12 more
- **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`

[Full history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/payments/:paymentId/refunds/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.dev/mollie/apis/mollie-api/revisions/b9d764add1c3?raw)