---
title: "Initiate a cashout"
method: POST
path: "/cashouts"
tags: ["CashOut"]
---

# Initiate a cashout

`POST /cashouts`

Initiates a [cashout](https://docs.adyen.com/platforms/cash-out-instantly) request.

## Request body

- CashOutInfo
  - `amount` Amount, required
    - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
    - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
  - `counterparty` CashOutInfoCounterparty
    - `transferInstrumentId` string — The unique identifier of the counterparty transfer instrument. If you do not provide this field, the cashout funds remain in the instructing balance account after the cashout transfer is settled.
  - `description` string — Allowed and returned only when you provide the `counterparty.transferInstrumentId` field. Your description of the cashout transfer. This description is used by most banks as the transfer description. We recommend sending a maximum of 140 characters, otherwise the description may be truncated. If you do not provide a description, Adyen generates a description automatically. This generated description is not returned in the response. Supported characters: **[a-z] [A-Z] [0-9] / - ? : ( ) . , ' + Space**.
  - `fee` Fee
    - `amount` Amount, required
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
      - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
  - `id` string — The ID of the resource.
  - `instructingBalanceAccountId` string, required — The unique identifier of the balance account that initiates the cashout request.
  - `referenceForBeneficiary` string — Allowed and returned only when you provide the `counterparty.transferInstrumentId` field. The reference that is sent to the recipient of a cashout transfer. This reference is also sent in all webhooks related to the cashout transfer, so you can use it to track the status of the transfer. If you do not provide a reference for the beneficiary, Adyen generates one automatically. This generated reference for the beneficiary is not returned in the response. Supported characters: **a-z**, **A-Z**, **0-9**.
  - `transferInstrumentId` string — **Use `counterparty.transferInstrumentId` instead.** The unique identifier of the counterparty transfer instrument.

## Response `200`

OK - The request has succeeded.

- CashOut
  - `amount` Amount, required
    - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
    - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
  - `counterparty` CashOutInfoCounterparty
    - `transferInstrumentId` string — The unique identifier of the counterparty transfer instrument. If you do not provide this field, the cashout funds remain in the instructing balance account after the cashout transfer is settled.
  - `description` string — Allowed and returned only when you provide the `counterparty.transferInstrumentId` field. Your description of the cashout transfer. This description is used by most banks as the transfer description. We recommend sending a maximum of 140 characters, otherwise the description may be truncated. If you do not provide a description, Adyen generates a description automatically. This generated description is not returned in the response. Supported characters: **[a-z] [A-Z] [0-9] / - ? : ( ) . , ' + Space**.
  - `fee` Fee
    - `amount` Amount, required
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
      - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
  - `id` string, required — The unique identifier of the cashout reference.
  - `instructingBalanceAccountId` string, required — The unique identifier of the balance account that initiates the cashout request.
  - `referenceForBeneficiary` string — Allowed and returned only when you provide the `counterparty.transferInstrumentId` field. The reference that is sent to the recipient of a cashout transfer. This reference is also sent in all webhooks related to the cashout transfer, so you can use it to track the status of the transfer. If you do not provide a reference for the beneficiary, Adyen generates one automatically. This generated reference for the beneficiary is not returned in the response. Supported characters: **a-z**, **A-Z**, **0-9**.
  - `transferInstrumentId` string — **Use `counterparty.transferInstrumentId` instead.** The unique identifier of the counterparty transfer instrument.
  - `transfers` CashOutTransfer[], required — The list of transfers related to cashout.
    - `amount` Amount, required
      - `currency` string, required — The three-character [ISO currency code](https://docs.adyen.com/development-resources/currency-codes#currency-codes) of the amount.
      - `value` integer, required — The numeric value of the amount, in [minor units](https://docs.adyen.com/development-resources/currency-codes#minor-units).
    - `id` string, required — The reference of the cashout transfer.
    - `type` 'cashoutRepayment' | 'cashoutFee', required — The type of the cashout transfer. Possible values: - **cashoutRepayment**: Corresponds to the transfer created to deduct the cashout amount after settlement. - **cashoutFee**: Corresponds to the transfer created to debit the cashout fee form the user's balance account.

## Other responses

- `400` — Bad Request - The request is malformed or is not in the expected format.
- `401` — Unauthorized - The API credential used in the request is invalid.
- `403` — Forbidden - The API credential does not have the right permissions.
- `404` — Not Found - The requested resource was not found.
- `422` — Unprocessable Entity - A request validation error.
- `429` — Too Many Requests - Request rate limit exceeded.
- `500` — Internal Service Error - An unrecoverable error occurred while trying to perform the request.

## Changes

- **2026-06-04** (v3) `e124e4fc0aa3` — 2 warning
  - removed the request property `creationDate`
  - removed the optional property `creationDate` from the response with the `200` status
- **2026-06-01** (v3) `2188d062ff1b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adyen/apis/transferservice/changes/cashouts/post.md)

---

[API](https://skmtc.dev/adyen/apis/transferservice.md) · [All operations](https://skmtc.dev/adyen/apis/transferservice/llms.txt) · [OpenAPI document](https://skmtc.dev/adyen/apis/transferservice/revisions/59603902985d?raw)