Sign in

v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-3196247792.5 KB
Custom payout schedules (sweeps)

Get a sweep

Returns a sweep.

get/balanceAccounts/{balanceAccountId}/sweeps/{sweepId}

Path parameters

balanceAccountIdstring required

The unique identifier of the balance account.

sweepIdstring required

The unique identifier of the sweep.

Response

OK - the request has succeeded.

category'bank' | 'internal' | 'platformPayment'

The type of transfer that results from the sweep.

Possible values:

Required when setting priorities.

currencystring required

The three-character ISO currency code in uppercase. For example, EUR.

The sweep currency must match any of the balances currencies.

descriptionstring

The message that will be used in the sweep transfer's description body with a maximum length of 140 characters.

If the message is longer after replacing placeholders, the message will be cut off at 140 characters.

idstring required

The unique identifier of the sweep.

prioritiesstring[]

The list of priorities for the bank transfer. This sets the speed at which the transfer is sent and the fees that you have to pay. You can provide multiple priorities, ordered by your preference. Adyen will try to pay out using the priorities in the given order. If the first priority is not currently supported or enabled for your platform, the system will try the next one, and so on.

The request will be accepted as long as at least one of the provided priorities is valid (i.e., supported by Adyen and activated for your platform). For example, if you provide ["wire","regular"], and wire is not supported but regular is, the request will still be accepted and processed.

Possible values:

  • regular: For normal, low-value transactions.

  • fast: A faster way to transfer funds, but the fees are higher. Recommended for high-priority, low-value transactions.

  • wire: The fastest way to transfer funds, but this has the highest fees. Recommended for high-priority, high-value transactions.

  • instant: For instant funds transfers within the United States and in SEPA locations.

  • crossBorder: For high-value transfers to a recipient in a different country.

  • internal: For transfers to an Adyen-issued business bank account (by bank account number/IBAN).

Set category to bank. For more details, see optional priorities setup for marketplaces or platforms.

reason'accountHierarchyNotActive' | 'amountLimitExceeded' | 'approved' | 'counterpartyAccountBlocked' | 'counterpartyAccountClosed' | 'counterpartyAccountNotFound' | 'counterpartyAddressRequired' | 'counterpartyBankTimedOut' | 'counterpartyBankUnavailable' | 'directDebitNotSupported' | 'error' | 'notEnoughBalance' | 'refusedByCounterpartyBank' | 'routeNotFound' | 'transferInstrumentDoesNotExist' | 'unknown'

The reason for disabling the sweep.

reasonDetailstring

The human readable reason for disabling the sweep.

referencestring

Your reference for the sweep configuration.

referenceForBeneficiarystring

The reference sent to or received from the counterparty. Only alphanumeric characters are allowed.

status'active' | 'inactive'

The status of the sweep. If not provided, by default, this is set to active.

Possible values:

  • active: the sweep is enabled and funds will be pulled in or pushed out based on the defined configuration.

  • inactive: the sweep is disabled and cannot be triggered.

type'pull' | 'push'

The direction of sweep, whether pushing out or pulling in funds to the balance account. If not provided, by default, this is set to push.

Possible values:

  • push: push out funds to a destination balance account or transfer instrument.

  • pull: pull in funds from a source merchant account, transfer instrument, or balance account.