> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Crypto Withdrawals

> List crypto withdrawals from a VelaFi merchant wallet, newest first, filtered by token, clientId, and time range.

Use this endpoint to track crypto withdrawals from a merchant wallet to external addresses, including those created with [Create Crypto Withdrawal](https://docs.velafi.com/api-reference/crypto-wallet/create-crypto-withdrawal.md). To be notified when a withdrawal reaches its final status, subscribe to [Crypto Withdrawal Event](https://docs.velafi.com/api-reference/webhooks/crypto-withdraw-message-push.md). You can also poll this endpoint by `clientId` until `status` is `6`, `7` or `9`, for example to reconcile withdrawals whose webhook you missed. Stablecoin payment refunds in this list don't trigger the webhook. The list can also include other withdrawal-type records, such as mass payouts. Withdrawals to a VelaFi wallet address are booked as internal transfers and appear in [Crypto Transfer History](https://docs.velafi.com/api-reference/merchant/query-crypto-transfers.md) instead. Results are sorted newest first, and a single call returns up to `pageSize` records. To find one withdrawal, filter by `clientId`.

> [!NOTE]
>
> All requests must include the `X-BH-TOKEN` header with a business token from `GET /v2/token/generate`.

## Endpoint

`GET https://api.velafi.com/v2/assets/withdrawalOrders`

## Query Parameters

**merchantId** `number` *required*

Merchant ID.

**crypto** `string`

Filter by token symbol, for example `USDT`.

**clientId** `string`

Filter by the `clientId` you supplied when creating the withdrawal.

**startTime** `number`

Only return withdrawals created at or after this time (Unix timestamp in milliseconds).

**endTime** `number`

Only return withdrawals created at or before this time (Unix timestamp in milliseconds).

**pageSize** `number` (default: 10)

Maximum number of records to return, from `1` to `1000`. Defaults to `10`.

## Response Fields

**code** `number`

`200` indicates success.

**msg** `string`

`SUCCESS` on success.

**data** `array`

**data item fields**

**orderId** `number`

Withdrawal record ID. It matches the `orderId` returned by Create Crypto Withdrawal.

**merchantId** `number`

Merchant whose wallet was debited.

**time** `number`

Time the withdrawal record was created (Unix timestamp in milliseconds).

**crypto** `string`

Token symbol.

**cryptoName** `string`

Token name. Currently the same as `crypto`.

**address** `string`

Destination address.

**addressTag** `string`

Destination memo or tag, if any.

**cryptoAmount** `string`

Withdrawal amount.

**fee** `string`

Network fee.

**feeCrypto** `string`

Token the fee is denominated in. This is always the same as `crypto`.

**arriveCryptoAmount** `string`

`cryptoAmount` minus `fee`.

**status** `number`

Withdrawal status:

* `5` — in progress, including withdrawals held for VelaFi's internal audit
* `6` — successful
* `7` — failed
* `9` — cancelled
* `0` — any other state, for example while the withdrawal is waiting for sub-account approval or is held for a risk information request (RFI)

**txId** `string`

On-chain transaction hash, once available.

**txIdUrl** `string`

Block-explorer link for the transaction.

**remark** `string`

The `remark` you supplied when creating the withdrawal.

## Example

```bash cURL theme={null}
curl -G https://api.velafi.com/v2/assets/withdrawalOrders \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  --data-urlencode "merchantId=151209" \
  --data-urlencode "clientId=withdraw-0001"
```


## Related topics

- [Create a Crypto Withdrawal](https://docs.velafi.com/api-reference/crypto-wallet/create-crypto-withdrawal.md)
- [Crypto Withdrawal Event](https://docs.velafi.com/api-reference/webhooks/crypto-withdraw-message-push.md)
- [List Crypto Deposits](https://docs.velafi.com/api-reference/crypto-wallet/get-crypto-deposit-history.md)
- [List Crypto Transfers](https://docs.velafi.com/api-reference/merchant/query-crypto-transfers.md)
- [Changelog](https://docs.velafi.com/docs/changelog.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.