---
title: "List Withdrawals"
method: GET
path: "/accounts/{account_id}/withdrawals"
tags: ["Money + Positions"]
---

# List Withdrawals

`GET /accounts/{account_id}/withdrawals`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/accounts/{account_id}/withdrawals`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/docs/accounts/:account_id/withdrawals/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `account_id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Headers

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

## Response `200`

Successful Response

- EncodedPaginatedCollectionResponseWithdrawalResponse
  - `data` WithdrawalResponse[], required: The elements of the response.
    - `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.
  - `pagination` EncodedPaginationResponse, required: Information about accessing elements beyond the ones that were returned.
    - `next_cursor` string: When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.

## Other responses

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

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)