Get Withdrawal

GET

/withdrawal/{id}/

Retrieves detailed information about a specific withdrawal by its ID.

Authentication

Requires OAuth 2.0 authentication with read and write scopes.

URL Parameters

Parameter	Type	Required	Description
`id`	string	Yes	The unique identifier (UUID) of the withdrawal

Example Request

curl -X GET {{BASE_URL}}/withdrawal/550e8400-e29b-41d4-a716-446655440000/ \
  -H "Authorization: Bearer your_access_token"

Response

Success Response (200 OK)

{
  "withdrawal_id": "550e8400-e29b-41d4-a716-446655440000",
  "custom_id": "WITHDRAW-123",
  "amount": "100.50000000",
  "requested_amount": "100.50000000",
  "fee": "1.50000000",
  "platform_fee": "1.00000000",
  "network_fee": "0.50000000",
  "blockchain": "ETH",
  "token": "USDT",
  "currency": "USDTERC20",
  "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "memo": null,
  "status": "completed",
  "transaction_hash": "0xab5d35434fe46ef9c5d215238a3dbb42d2f3c84e7a36f80c61244ea9ac81ef73",
  "confirmations": 24,
  "required_confirmations": 12,
  "batch_id": "batch-980cf45a",
  "callback_url": "https://your-site.com/webhook/withdrawal",
  "created_at": "2025-04-10T15:30:00Z",
  "updated_at": "2025-04-10T16:45:12Z",
  "completed_at": "2025-04-10T16:45:12Z"
}

Response Fields

Field	Type	Description
`withdrawal_id`	string	Unique withdrawal identifier
`custom_id`	string	Your custom reference ID, if provided
`amount`	string	Withdrawal amount
`requested_amount`	string	Originally requested amount
`fee`	string	Total fee (platform + network)
`platform_fee`	string	Platform processing fee
`network_fee`	string	Blockchain network fee
`blockchain`	string	Blockchain network used
`token`	string	Token being withdrawn
`currency`	string	Combined currency code
`address`	string	Destination wallet address
`memo`	string	Memo or tag, if provided
`status`	string	Current withdrawal status
`transaction_hash`	string	Blockchain transaction hash (null until processed)
`confirmations`	integer	Number of blockchain confirmations
`required_confirmations`	integer	Required confirmations for completion
`batch_id`	string	Withdrawal batch ID, if part of a batch
`callback_url`	string	Webhook callback URL
`created_at`	string	ISO 8601 timestamp of creation
`updated_at`	string	ISO 8601 timestamp of last update
`completed_at`	string	ISO 8601 timestamp of completion (null until completed)

Error Responses

404 Not Found

{
  "error": {
    "code": "not_found",
    "message": "The specified withdrawal does not exist or belongs to another user",
    "details": {}
  }
}

Notes

The transaction_hash field is only available for withdrawals that have been submitted to the blockchain
The confirmations field indicates how many blockchain confirmations the transaction has received
The batch_id field is only present if the withdrawal is part of a processing batch
The completed_at field is null until the withdrawal reaches a terminal state