---
title: "Master Wallet"
method: POST
path: "/v1/wallets/{walletId}/withdraw"
tags: ["Withdraw"]
---

# Master Wallet

`POST /v1/wallets/{walletId}/withdraw`

This endpoint allows you to initiate a withdrawal from a specific wallet.

### Body Parameters

| Key | Required | Type | Description |
| --- | --- | --- | --- |
| assetId | true\* | string (UUID) | The ID of the asset to withdraw. Required if `assets` array is **not** provided. |
| address | true\* | string | The destination wallet address for the withdrawal. Required if `assets` array is **not** provided. |
| amount | true\* | string | The withdrawal amount. Must be greater than 0. Required if `assets` array is **not** provided. |
| reference | false | string | An optional reference note for the withdrawal. |
| **note** | false | string | A short message or internal remark to associate with this withdrawal. Not visible on-chain. |
| metadata | false | object | Optional metadata (key-value pairs) for additional transaction details. |
| assets | false | array of `Asset` | Used for **batch withdrawals**. Required if `assetId`, `amount`, and `address` are **not** provided. |

### Asset (for Batch Withdrawals)

| Key | Required | Type | Description |
| --- | --- | --- | --- |
| id | true | string (UUID) | The ID of the asset to withdraw. |
| amount | true | string | The withdrawal amount. Must be greater than 0. |
| address | true | string | The destination wallet address for the withdrawal. |
| reference | false | string | Optional reference note for this asset withdrawal. |
| **note** | false | string | A short message or internal remark for this asset withdrawal. Not visible on-chain. |
| metadata | false | object | Optional metadata (key-value pairs) for this asset withdrawal. |

---

### Notes

- **Single withdrawal**: Provide `assetId`, `amount`, and `address` at the top level.
- **Batch withdrawal**: Omit top-level `assetId`, `amount`, and `address`, and instead provide an array of `assets` (each following `Asset`).

## Request body

- object
  - `assets` object[]
    - `address` string
    - `amount` string
    - `id` string
    - `metadata` object
      - `employeeId` string
      - `invoiceId` string
    - `note` string
    - `reference` string

## Response `200`

Withdraw / Withdraw (Batch)

- object
  - `data` object
    - `amlScreening` unknown
    - `amount` string
    - `amountPaid` string
    - `asset` object
      - `address` string
      - `blockchain` object
        - `createdAt` string
        - `derivationPath` string
        - `id` string
        - `isActive` boolean
        - `isEvmCompatible` boolean
        - `logoUrl` string
        - `name` string
        - `slug` string
        - `symbol` string
        - `tokenStandard` string
        - `updatedAt` string
      - `createdAt` string
      - `decimals` number
      - `id` string
      - `isActive` boolean
      - `logoUrl` string
      - `name` string
      - `network` string
      - `standard` string
      - `symbol` string
      - `updatedAt` string
    - `assetSwept` unknown
    - `assetSweptAmount` unknown
    - `assetSweptAt` unknown
    - `assetSweptGasFee` unknown
    - `assetSweptHash` unknown
    - `assetSweptRecipientAddress` unknown
    - `assetSweptResponse` unknown
    - `assetSweptSenderAddress` unknown
    - `blockHash` unknown
    - `blockNumber` unknown
    - `blockchain` object
      - `createdAt` string
      - `derivationPath` string
      - `id` string
      - `isActive` boolean
      - `isEvmCompatible` boolean
      - `logoUrl` string
      - `name` string
      - `slug` string
      - `symbol` string
      - `tokenStandard` string
      - `updatedAt` string
    - `chainId` unknown
    - `confirmations` unknown
    - `confirmed` boolean
    - `createdAt` string
    - `currency` string
    - `errors` unknown[]
      - unknown
    - `fee` unknown
    - `feeMetadata` unknown
    - `gasFee` unknown
    - `gasPrice` unknown
    - `gasUsed` unknown
    - `hash` string
    - `id` string
    - `metadata` unknown
    - `network` string
    - `note` unknown
    - `reason` unknown
    - `recipientAddress` string
    - `senderAddress` string
    - `status` string
    - `success` object[]
      - `amount` string
      - `id` string
      - `recipientAddress` string
      - `reference` string
      - `senderAddress` string
      - `status` string
    - `tokenAddress` unknown
    - `type` string
    - `updatedAt` string
    - `wallet` object
      - `id` string
  - `message` string
  - `statusCode` number

---

[API](https://skmtc.net/blockradar/apis/blockradar-documentation.md) · [All operations](https://skmtc.net/blockradar/apis/blockradar-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockradar/blockradar-documentation/revisions/97f95b4cfc0d/schema)