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

# Get a specific managed payout schedule on your balance platform

`GET /balancePlatforms/{balancePlatformId}/payoutSchedules/{id}`

## Request

- Base URL: `https://balanceplatform-api-test.adyen.com/bcl/v2`
- URL: `https://balanceplatform-api-test.adyen.com/bcl/v2/balancePlatforms/{balancePlatformId}/payoutSchedules/{id}`
- Auth: none declared

Returns the specified managed payout schedule configured on your balance platform.

## Path parameters

- `balancePlatformId` string, required
- `id` string, required

## Response `200`

OK - The request has succeeded.

- BalancePlatformConfiguration
  - `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` string, required: The time when the payout funds are settled in your user's transfer instrument. For example, 11:30:00.
  - `userSettlementTimeZone` string, required: The timezone of the `userSettlementTime`.

## Other responses

- `401`: Unauthorized - authentication required.
- `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.

## Changes

- **2026-10-21** (v2) `89a469ab11aa`: 1 breaking, 4 warning, 1 info
  - the `userSettlementTime` response's property type changed from `object` to `string` for status `200`
  - removed the optional property `userSettlementTime/hour` from the response with the `200` status
  - removed the optional property `userSettlementTime/minute` from the response with the `200` status
  - removed the optional property `userSettlementTime/nano` from the response with the `200` status
  - …2 more
- **2026-05-19** (v2) `87544766dc8e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adyen/apis/balanceplatformservice/changes/balancePlatforms/:balancePlatformId/payoutSchedules/:id/get.md)

---

[API](https://skmtc.dev/adyen/apis/balanceplatformservice.md) - [All operations](https://skmtc.dev/adyen/apis/balanceplatformservice/llms.txt) - [OpenAPI document](https://skmtc.dev/adyen/apis/balanceplatformservice/revisions/89a469ab11aa?raw)