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

# List payouts

`GET /payouts`

## Request

- Base URL: `https://api.mollie.com/v2`
- URL: `https://api.mollie.com/v2/payouts`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

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.

> 🔑 Access with
>
> [API key](/reference/authentication)
>
> [Advanced access token with **payouts.read**](/reference/authentication)

## Query parameters

- `balanceId` string, nullable
- `from` string
- `limit` integer, nullable
- `sort` string
- `testmode` boolean

## Response `200`

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

- object
  - `count` integer, required: The number of items in this result set. If more items are available, a `_links.next` URL will be present in the result as well. The maximum number of items per result set is controlled by the `limit` property provided in the request. The default limit is 50 items.
  - `_embedded` object, required
    - `payouts` object[], required: An array of payout objects. For a complete reference of the payout object, refer to the [Get payout endpoint](get-payout) documentation.
      - `resource` string, required: Indicates the response contains a payout object. Will always contain the string `payout` for this endpoint.
      - `id` string, required: The identifier uniquely referring to this payout. Mollie assigns this identifier at payout creation time. Mollie will always refer to the payout by this ID. Example: `payout_j8NvRAM2WNZtsykpLEX8J`.
      - `balanceId` string, required: The identifier of the balance that will be paid out. Example: `bal_gVMhHKqSSRYJyPsuoPNFH`.
      - `amount` object, nullable: The amount to pay out. When omitted from the request, the full available balance minus any configured balance reserve is paid out. Merchants registered in the United Kingdom cannot specify a custom amount — omit this field to pay out the full available balance. The value in the response reflects the amount paid out, excluding any applicable fees.
        - `currency` string, required: A three-character ISO 4217 currency code.
        - `value` string, required: A string containing an exact monetary amount in the given currency.
      - `description` string, nullable: The description that will appear on the bank statement for this payout.
      - `status` string, required: The status of the payout. Possible values: `requested` `initiated` `processing-at-bank` `completed` `failed` `canceled`
      - `statusReason` object, required: The reason for the payout's current status.
        - `code` string, required: A machine-readable code describing the reason for the payout's current status. Possible values: `requested` `initiated` `processing_at_bank` `completed` `canceled` `failed` `insufficient_funds` `returned` `invalid_request` `organization_inactive` `payouts_blocked` `bank_processing_failed` `balance_not_found` `expired`
        - `message` string, required: A human-readable description of the status reason.
      - `createdAt` string, required: The entity's date and time of creation, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
      - `initiatedAt` string, nullable: The date and time the payout was initiated, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. This is the moment Mollie attempted to reserve the funds on the balance.
      - `completedAt` string, nullable: The date and time the payout was sent to the destination bank account, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. `null` if the payout has not completed yet.
      - `canceledAt` string, nullable: The date and time the payout was canceled, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. `null` if the payout was not canceled.
      - `mode` string, required: Whether this entity was created in live mode or in test mode. Possible values: `live` `test`
      - `testmode` boolean, nullable: Whether to create the entity in test mode or live mode. Most API credentials are specifically created for either live mode or test mode, in which case this parameter must not be sent. For organization-level credentials such as OAuth access tokens, you can enable test mode by setting `testmode` to `true`.
      - `_links` object: An object with several relevant URLs. Every URL object will contain an `href` and a `type` field.
        - `self` object, required: The URL to the current resource.
          - `href` string, required: The actual URL string.
          - `type` string, required: The content type of the page or endpoint the URL points to.
  - `_links` object, required: Links to help navigate through the lists of items. Every URL object will contain an `href` and a `type` field.
    - `self` object, required: The URL to the current set of items.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.
    - `previous` object, nullable, required: The previous set of items, if available.
      - `href` string: The actual URL string.
      - `type` string: The content type of the page or endpoint the URL points to.
    - `next` object, nullable, required: The next set of items, if available.
      - `href` string: The actual URL string.
      - `type` string: The content type of the page or endpoint the URL points to.
    - `documentation` object, required: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.

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

---

[API](https://skmtc.dev/mollie/apis/business-operations.md) - [All operations](https://skmtc.dev/mollie/apis/business-operations/llms.txt) - [OpenAPI document](https://skmtc.dev/mollie/apis/business-operations/revisions/d51d76f4e5d9?raw)