Create withdrawal request

Creates new withdrawal requests to be settled. Withdrawal requests created through the API go directly into an APPROVED state.

Specifying the destination

Provide exactly one of the following per request (zerohash always responds with withdrawal_account_id):

MethodFieldUse for
Saved accountwithdrawal_account_idPre-whitelisted crypto address or fiat account (recommended)
Inline cryptoaddress (+ destination_tag for tag assets)An on-chain address
Inline fiataccount{}A bank wire (DOMESTIC / REAL_TIME / INTERNATIONAL)

To retrieve saved account IDs use GET /withdrawals/digital_asset_addresses (crypto) and GET /withdrawals/fiat_accounts (fiat).

💡 Use the Examples dropdown on the request body to see a ready-to-use request for each destination method and withdrawal type.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Withdrawal request details including account ID, asset, amount, and destination information.

Headers
string
required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

string
required

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json