Get all managed payout schedules on a balance account

get/balanceAccounts/{balanceAccountId}/payoutSchedules

Returns a list of all managed payout schedules that are configured on a balance account. You can use query parameters to filter the elements that are returned in the list.

Endpoint destination URL

https://balanceplatform-api-test.adyen.com/bcl/v2/balanceAccounts/{balanceAccountId}/payoutSchedules

Query Parameters

Required

Optional

Minimum: 1Maximum: 100

The number of items returned per page, maximum of 100 items. By default, the response returns 10 items per page.

The cursor returned in the links of the previous response.

The three-character ISO currency code of the currency used in the payout schedule.

Path Parameters

Required

Optional

The unique identifier of the balance account.

Response parameters

After submitting a call, you receive a response message to inform you that your request was received and processed.

Depending on the HTTP status code of the response message, it is helpful to build some logic to handle any errors that a request or the system may return.

HTTP Responses

200 - OK
The request has succeeded.
balanceAccountPayoutSchedulesarray[object]
Contains a list of the Balance Account payout schedules.
balanceAccountIdstring
The unique identifier of the balance account to which you apply the payout schedule.
balancePlatformPayoutScheduleIdstring
The unique identifier of the balance platform payout schedule that is applied to the balance account.
createdAtstring
The date and time when the payout schedule was created.
currencystring
The three-character ISO code of the currency used for this schedule.
descriptionstring
The description used for all payouts initiated by this payout schedule.

Maximum length: 140 characters. If your description is longer, it may be truncated.

Default value: The defaultDescription from the balance platform schedule that you are applying.
enabledboolean
Specifies whether the payout schedule is active.
frequencystring
The frequency of payouts initiated by this payout schedule.

Possible values:

daily

weekdays

weekly

monthly

Default value: The defaultFrequency from the balance platform schedule that you are applying.
frequencyValueinteger
The date of the month or day of the week when payouts are initiated. Allowed only if frequency is monthly or weekly.

Possible values if frequency 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 frequency is weekly: [1 - 5].

Default value: The defaultFrequencyValue from the balance platform schedule that you are applying.
idstring
The unique identifier of the payout schedule for the balance account.
maxPayoutAmountinteger
The maximum amount that can be paid out from balance accounts that use this payout schedule.

Default value: 0
minPayoutAmountinteger
The minimum amount that can be paid out from balance accounts that use this payout schedule.

Default value: 0
referencestring
Your reference for the payout schedule. This reference does not appear on statements of payouts initiated by the payout schedule.
referenceForBeneficiarystring
The reference for beneficiary used for all payouts initiated by this payout schedule. This reference is sent to the recipient of the payout and is included in all webhooks related to the payout.

Supported characters: a-z, A-Z, 0-9.

Default value: The defaultReferenceForBeneficiary from the balance platform schedule that you are applying.
retainedAmountinteger
The amount of funds that must remain available in the 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
salesDayClosingTimestringDeprecated
The time of day when the sales day is closed in balance account time zone. The sales day closing time can be between 00:00 to 07:00.

Format: HH:mm:ss
transferInstrumentIdstring
The unique identifier of the transfer instrument to which the funds are paid out.
updatedAtstring
The date and time when the payout schedule was updated.
linkobject
Contains links to the next and previous page whenever applicable.
firstobject
The link to the first page of the list.
hrefstring
lastobject
The link to the last page of the list.
hrefstring
nextobject
The link to the next page of the list.
hrefstring
previousobject
The link to the previous page of the list.
hrefstring
selfobject
The link to the list page you are currently viewing.
hrefstring
401 - Unauthorized
Authentication required.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
messagestring
Description of the validation error.
namestring
The field that has an invalid value.
valuestring
The invalid value.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.
403 - Forbidden
Insufficient permissions to process the request.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
messagestring
Description of the validation error.
namestring
The field that has an invalid value.
valuestring
The invalid value.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.
404 - Not Found
The resource was not found
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
messagestring
Description of the validation error.
namestring
The field that has an invalid value.
valuestring
The invalid value.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.
422 - Unprocessable Entity
A request validation error.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
messagestring
Description of the validation error.
namestring
The field that has an invalid value.
valuestring
The invalid value.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.
500 - Internal Server Error
The server could not process the request.
detailstring
A human-readable explanation specific to this occurrence of the problem.
errorCodestring
Unique business error code.
instancestring
A URI that identifies the specific occurrence of the problem if applicable.
invalidFieldsarray[object]
Array of fields with validation errors when applicable.
messagestring
Description of the validation error.
namestring
The field that has an invalid value.
valuestring
The invalid value.
requestIdstring
The unique reference for the request.
statusinteger
The HTTP status code.
titlestring
A short, human-readable summary of the problem type.
typestring
A URI that identifies the validation error type. It points to human-readable documentation for the problem type.

Get all managed payout schedules on a balance account

HTTP Responses

200 - OK

401 - Unauthorized

403 - Forbidden

404 - Not Found

422 - Unprocessable Entity

500 - Internal Server Error