---
title: "Get all managed payout schedules on your balance platform"
method: GET
path: "/balancePlatforms/{balancePlatformId}/payoutSchedules"
tags: ["Managed payout schedules"]
---

# Get all managed payout schedules on your balance platform

`GET /balancePlatforms/{balancePlatformId}/payoutSchedules`

Returns a list of all the payout schedules that are configured for your balance platform. You can use query parameters to filter the elements that are returned in the list.

## Path parameters

- `balancePlatformId` string, required

## Query parameters

- `countryCode` string
- `currency` string

## Response `200`

OK - The request has succeeded.

- BalancePlatformConfigurations
  - `balancePlatformPayoutSchedules` BalancePlatformConfiguration[], required — Contains a list of the payout schedules configured in your balance platform.
    - `automaticApplication` boolean — Specifies whether this payout schedule is automatically applied to new balance accounts.
    - `balancePlatformId` string, required — The balance platform to which the payout schedule applies.
    - `countryCode` string — The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) code of the country to which the payout schedule applies.
    - `createdAt` string, date-time, required — The date when the payout schedule was created.
    - `currency` string — The three-character [ISO code](https://docs.adyen.com/development-resources/currency-codes) of the currency used for the payout schedule.
    - `defaultDescription` string — The default description for payouts initiated by this payout schedule.
    - `defaultFrequency` string
    - `defaultFrequencyValue` integer — The default value for date of the month or day of the week when payouts are initiated. Allowed only if `defaultFrequency` is **monthly** or **weekly**. Possible values if `defaultFrequency` is **monthly**: **[1 - 31]**. * If your specified date happens on a weekend, the payout is initiated on the next business day. * If your specified date (**29**, **30**, or **31**) does not exist in a month, the payout is initiated on the last day of that month. Possible values if `defaultFrequency` is **weekly**: **[1 - 5]**.
    - `defaultReference` string — Your internal default reference for the payout schedule.When the payout schedule is applied to a balance account, this reference is also used for that payout schedule.
    - `defaultReferenceForBeneficiary` string — The default reference for beneficiary for payouts initiated by this payout schedule.
    - `enabled` boolean — Specifies whether the payout schedule is enabled immediately after it is created.
    - `id` string — The unique identifier of the payout schedule for your balance platform.
    - `maxPayoutAmount` integer — The maximum amount that can be paid out from balance accounts that use this payout schedule. Default value: **0**, which means that there is no maximum limit.
    - `minPayoutAmount` integer — The minimum amount that can be paid out from balance accounts that use this payout schedule. Default value: **0**.
    - `payoutScheduleDescription` string, required — The type of payout schedule. This type indicates how fast funds are paid out to your user. Possible values: - **Standard**: The funds arrive in your user's transfer instrument two days after the funds are settled. - **Accelerated**: The funds arrive to your user's transfer instrument the day after the funds are settled.
    - `retainedAmount` integer — The amount of funds that must remain available in a balance account after an execution of the payout schedule. If the funds in the balance account are less than the retained amount, the execution is not initiated. Default value: **0**
    - `updatedAt` string, date-time — The date when the payout schedule was updated.
    - `userSettlementDelay` integer, required — The default [settlement delay](https://docs.adyen.com/platforms/settle-funds/#settlement-delay) for this payout schedule.
    - `userSettlementTime` LocalTime, required
      - `hour` integer
      - `minute` integer
      - `nano` integer
      - `second` integer
    - `userSettlementTimeZone` string, required — The timezone of the `userSettlementTime`.

## Other responses

- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `404` — Not Found - the resource was not found
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

---

[API](https://skmtc.net/adyen/apis/balanceplatformservice.md) · [All operations](https://skmtc.net/adyen/apis/balanceplatformservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adyen/balanceplatformservice/revisions/8761ac1a9aab/schema)