---
title: "List payouts"
method: GET
path: "/v1.0/merchants/{merchant_code}/payouts"
tags: ["Payouts"]
---

# List payouts

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

Lists payout and payout-deduction records for the specified merchant account within the requested date range.

The response can include:
- regular payouts (`type = PAYOUT`)
- deduction records for refunds, chargebacks, direct debit returns, or balance adjustments

Results are sorted by payout date in the requested `order`.

## Path parameters

- `merchant_code` string, required

## Query parameters

- `start_date` string, date, required
- `end_date` string, date, required
- `format` 'json' | 'csv'
- `limit` integer
- `order` 'asc' | 'desc'

## Response `200`

Returns the list of payout and deduction records for the requested period.

- FinancialPayout[] — Ordered list of payout and payout-deduction records.
  - `id` integer, required — Unique identifier of the payout-related record.
  - `type` 'PAYOUT' | 'CHARGE_BACK_DEDUCTION' | 'REFUND_DEDUCTION' | 'DD_RETURN_DEDUCTION' | 'BALANCE_DEDUCTION', required — High-level payout record category.
  - `amount` number, float, required — Amount of the payout or deduction in major units.
  - `date` string, date, required — Payout date associated with the record, in `YYYY-MM-DD` format.
  - `currency` string, required — Three-letter ISO 4217 currency code of the payout.
  - `fee` number, float, required — Fee amount associated with the payout record, in major units.
  - `status` 'SUCCESSFUL' | 'FAILED', required — Merchant-facing outcome of the payout record.
  - `reference` string, required — Processor or payout reference associated with the record.
  - `transaction_code` string, required — Transaction code of the original sale associated with the payout or deduction.

## Other responses

- `400` — The request is invalid for the submitted query parameters.
- `401` — The request is not authorized.

## 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`
  - …10 more
- **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
  - …4 more
- **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

[Change history](https://skmtc.dev/sumup/apis/sumup-rest-api/changes/v1.0/merchants/:merchant_code/payouts/get.md)

---

[API](https://skmtc.dev/sumup/apis/sumup-rest-api.md) · [All operations](https://skmtc.dev/sumup/apis/sumup-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sumup/sumup-rest-api/revisions/b050b86c35d1/schema)