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

# List payouts

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

Lists ordered payouts for the merchant profile.

## Path parameters

- `merchant_code` string, required

## Query parameters

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

## Response `200`

OK

- object[]
  - `amount` number, float
  - `currency` string
  - `date` string, date
  - `fee` number, float
  - `id` integer
  - `reference` string
  - `status` 'SUCCESSFUL' | 'FAILED'
  - `transaction_code` string
  - `type` 'PAYOUT' | 'CHARGE_BACK_DEDUCTION' | 'REFUND_DEDUCTION' | 'DD_RETURN_DEDUCTION' | 'BALANCE_DEDUCTION'

## Other responses

- `401` — Unauthorized

## Changes

- **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/d32eef8a3bd2/schema)