---
title: "Changes to List payouts"
method: GET
path: "/v1.0/merchants/{merchant_code}/payouts"
---

# Changes to List payouts

`GET /v1.0/merchants/{merchant_code}/payouts`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 79 revisions.

- **2026-07-10** `c75ca16e1e44`: 1 info
- **2026-04-27** `b54086fdb4cc`: 2 breaking, 2 warning, 10 info
- **2026-03-11** `cd79d83b07e0`: 2 warning, 6 info
- **2025-02-25** `cdadac3315a1`: 2 info
- **2025-01-31** `b2658ad0a0e9`: 1 info

## Changes

- **2026-07-10** `c75ca16e1e44`: 1 info
  - the security scope `payouts.read` was added to the endpoint's security scheme `oauth2`
- **2026-04-27** `b54086fdb4cc`: 2 breaking, 2 warning, 10 info
  - for the `query` request parameter `format`, default value `json` was added
  - for the `query` request parameter `order`, default value `asc` was added
  - for the `query` request parameter `limit`, the max was set to `9999.00`
  - for the `query` request parameter `limit`, the min was set to `1.00`
  - added the media type `text/plain` for the response with the status `200`
  - the response property `items/amount` became required for the status `200`
  - the response property `items/currency` became required for the status `200`
  - the response property `items/date` became required for the status `200`
  - the response property `items/fee` became required for the status `200`
  - the response property `items/id` became required for the status `200`
  - the response property `items/reference` became required for the status `200`
  - the response property `items/status` became required for the status `200`
  - the response property `items/transaction_code` became required for the status `200`
  - the response property `items/type` became required for the status `200`
- **2026-03-11** `cd79d83b07e0`: 2 warning, 6 info
  - removed the optional property `error_code` from the response with the `401` status
  - removed the optional property `message` from the response with the `401` status
  - added the non-success response with the status `400`
  - added the optional property `detail` to the response with the `401` status
  - added the optional property `instance` to the response with the `401` status
  - added the optional property `status` to the response with the `401` status
  - added the optional property `title` to the response with the `401` status
  - added the required property `type` to the response with the `401` status
- **2025-02-25** `cdadac3315a1`: 2 info
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `oauth2` was added to the API
- **2025-01-31** `b2658ad0a0e9`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/sumup/apis/sumup-rest-api/docs/v1.0/merchants/:merchant_code/payouts/get.md) - [API](https://skmtc.dev/sumup/apis/sumup-rest-api.md) - [Page](https://skmtc.dev/sumup/apis/sumup-rest-api/changes/v1.0/merchants/:merchant_code/payouts/get)