Skip to main content
GET
Get a stablecoin withdrawal

What this endpoint does

Returns the authoritative amount, fee, reservation, destination, transaction reference, and lifecycle for one withdrawal.

When to use it

Use it after a webhook, timeout, hold, or support question to determine the current on-chain outcome.

Before you call

Authenticate with treasury:read and pass a withdrawal ID owned by the same tenant account.

Money and balance effect

This is a read-only request. It does not reserve, debit, credit, or settle money.

States and completion

Read status, confirmations or finality, reservation state, reason, and next action together. Unknown is not failed and must be reconciled.

Safe retries

GET requests are read-only and may be retried with normal exponential backoff. Do not send an Idempotency-Key. Read Conversions and withdrawals for the complete workflow.

Authorizations

Authorization
string
header
required

Send the same Wayex API key as Authorization: Bearer <key>.

Path Parameters

id
string
required

Response

200 - application/json
id
string
required
Minimum string length: 1
clientId
string
required
Minimum string length: 1
asset
enum<string>
required
Available options:
USDC,
USDT
network
enum<string>
required
Available options:
ethereum,
base,
arbitrum,
optimism,
polygon,
bsc,
avalanche,
solana,
tron
amount
string
required
Pattern: ^\d+(\.\d+)?$
fee
object
required
sourceDebit
object
required
destinationAddress
string
required
Minimum string length: 1
status
enum<string>
required
Available options:
accepted,
held,
submitted,
settled,
failed,
returned
configurationId
string
required
Minimum string length: 1
externalReference
string
required
Minimum string length: 1
reservation
object
required
nextAction
enum<string>
required
Available options:
none,
wait_for_settlement,
contact_support,
retry_new_request,
review_balance
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
destinationId
string
Minimum string length: 1
destinationTag
string
Minimum string length: 1
providerReference
string
Minimum string length: 1
statusReason
string
Minimum string length: 1