---
title: "List payouts"
method: GET
path: "/v2/payouts"
tags: ["Payouts API"]
---

# List payouts

`GET /v2/payouts`

Retrieve a list of all payouts for your organization, including payouts initiated automatically by the
balance's payout schedule and payouts requested via the API or dashboard.

Only payouts created on or after April 1st, 2026 are returned.

The results are paginated. Use the `from` query parameter together with `_links.next` to iterate through
the full result set.

## Query parameters

- `balanceId` string, nullable
- `from` string, nullable
- `limit` integer, nullable
- `sort` 'asc' | 'desc'
- `testmode` boolean

## Headers

- `idempotency-key` string

## Response `200`

A list of payout objects. For a complete reference of the payout object, refer to the
[Get payout endpoint](get-payout) documentation.

## Other responses

- `400` — The request contains issues. For example, if the specified `from` value is not a valid ID.
- `429` — Rate Limit has been reached.

## Changes

> 79 revisions in range; 9 not diffed.

- **2026-08-05** `40ce187fe729` — 1 breaking
  - the response property `_embedded/payouts/items/description` became nullable for the status `200`
- **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-22** `1fdc21356fc6` — 1 info
  - the endpoint scheme security `oAuth` was removed from the API
- **2026-05-19** `7cab62b21830` — 1 info
  - added the non-success response with the status `429`
- **2026-05-13** `c9097984fd6b` — 2 breaking, 3 info
  - the response property `_embedded/payouts/items/amount` became nullable for the status `200`
  - the `_embedded/payouts/items/amount` response's property type changed from no type to `object, null` for status `200`
  - removed `#/components/schemas/amount-nullable` from the `_embedded/payouts/items/amount` response property `allOf` list for the response status `200`
  - added the required property `_embedded/payouts/items/amount/currency` to the response with the `200` status
  - …1 more

[Full history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/payouts/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-service-production.skmtc.workers.dev/v1/apis/mollie/mollie-api/revisions/b7497b77b18f/schema)