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, reservation state, reason, and next action together. Confirmation counts are not exposed; the status moves to settled only after on-chain finality is reached. 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
txHash
string | null

On-chain transaction hash. Resolvable on a block explorer for this withdrawal's network.

Minimum string length: 1