---
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.

---

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