---
title: "Create Withdrawal"
method: POST
path: "/accounts/{account_id}/withdrawals"
tags: ["Money + Positions"]
---

# Create Withdrawal

`POST /accounts/{account_id}/withdrawals`

## Path parameters

- `account_id` string, required

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Request body

- CreateWithdrawalRequest
  - `amount` string, number, required — The amount of money to withdraw.
  - `currency` string — An ISO 4217 three-letter currency code. Its value represents the currency for the amount listed here. The only currently available currency is `"EUR"`.

## Response `201`

Successful Response

- WithdrawalResponse
  - `id` string, required — A string representing the unique identifier of this transaction.
  - `status` 'accepted' | 'canceled' | 'confirmed' | 'created' | 'processed' | 'rejected', required — A category representing a withdrawal's status: <ul> <li><code>accepted</code> <li><code>canceled</code> <li><code>confirmed</code> <li><code>created</code> <li><code>processed</code> <li><code>rejected</code> </ul>
  - `amount` union, required — The amount of money to withdraw.
    - number
    - string
  - `currency` string, required — An ISO 4217 three-letter currency code. Its value represents the currency for the amount listed here. The only currently available currency is `"EUR"`.
  - `receiving_account` BankAccountResponse, required — An object representing a bank account.
    - `iban` string, required — An IBAN (International Bank Account Number) according to ISO 13616-1:2020.
    - `bic` string, required — A BIC (Business Identifier Code) according to ISO 9362.
    - `name` string — The name of the bank managing the bank account.
  - `sca` StrongCustomerAuthenticationRequest — An object representing a strong customer authentication challenge.
    - `required` boolean, required — Indication of strong customer authentication requirement. If this value is `true`, the next request needs to include a solution to the challege (e.g. in the `sca` property for batch order confirmation).
    - `challenge` string, required — A base64-url encoded blob of data. Sign the decoded data using a registered authenticator and include the signature in the next request (e.g. in the `sca` property for batch order confirmation).
  - `history` StatusChangeWithdrawalStatus[], required — A history of the status changes for a withdrawal.
    - `status` 'accepted' | 'canceled' | 'confirmed' | 'created' | 'processed' | 'rejected', required — A category representing a withdrawal's status: <ul> <li><code>accepted</code> <li><code>canceled</code> <li><code>confirmed</code> <li><code>created</code> <li><code>processed</code> <li><code>rejected</code> </ul>
    - `timestamp` string, date-time, required — The timestamp of the event. It represents the point in time at which the withdrawal was updated.
  - `created_at` string, date-time — The timestamp of the withdrawal. It represents the point in time at which the withdrawal was created. **NOTE:** Deprecated as of 2024-06, use `history` to query this information.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `5XX` — Server Error

---

[API](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api.md) · [All operations](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemon/lemon-markets-brokerage-api/revisions/3c8cfd3a96c9/schema)