---
title: "Child Address Withdraw"
method: POST
path: "/v1/addresses/{addressId}/gateway/withdraw"
tags: ["Gateway"]
---

# Child Address Withdraw

`POST /v1/addresses/{addressId}/gateway/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. |

---

### 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
  - `address` string
  - `amount` string
  - `blockchain` string
  - `code` string
  - `metadata` string
  - `note` string
  - `reference` string

## Response `200`

200

- object
  - `data` object
    - `amlScreening` object
      - `message` string
      - `provider` string
      - `status` string
    - `amount` string
    - `amountPaid` string
    - `amountUSD` string
    - `asset` object
      - `address` string
      - `createdAt` string
      - `currency` string
      - `decimals` number
      - `id` string
      - `isActive` boolean
      - `isNative` boolean
      - `name` string
      - `network` string
      - `standard` unknown
      - `symbol` string
      - `updatedAt` string
    - `assetSwept` unknown
    - `assetSweptAmount` unknown
    - `assetSweptAt` unknown
    - `assetSweptGasFee` unknown
    - `assetSweptHash` unknown
    - `assetSweptRecipientAddress` unknown
    - `assetSweptSenderAddress` unknown
    - `blockHash` unknown
    - `blockNumber` unknown
    - `blockchain` object
      - `createdAt` string
      - `derivationPath` string
      - `id` string
      - `isActive` boolean
      - `isEvmCompatible` boolean
      - `isL2` boolean
      - `name` string
      - `slug` string
      - `symbol` string
      - `tokenStandard` unknown
      - `updatedAt` string
    - `chainId` number
    - `confirmations` unknown
    - `confirmed` boolean
    - `createdAt` string
    - `currency` string
    - `fee` unknown
    - `feeHash` unknown
    - `gasFee` unknown
    - `gasPrice` unknown
    - `gasUsed` unknown
    - `hash` unknown
    - `id` string
    - `metadata` unknown
    - `network` string
    - `note` string
    - `rate` unknown
    - `rateUSD` string
    - `reason` string
    - `recipientAddress` string
    - `reference` string
    - `senderAddress` string
    - `signedTransaction` unknown
    - `status` string
    - `toAmount` unknown
    - `toCurrency` unknown
    - `tokenAddress` unknown
    - `type` string
    - `updatedAt` string
    - `wallet` object
      - `address` string
      - `configurations` unknown
      - `createdAt` string
      - `derivationPath` string
      - `description` string
      - `id` string
      - `isActive` boolean
      - `name` string
      - `network` string
      - `status` string
      - `updatedAt` 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)