Skip to main content

Get Withdrawal Status

POST
/withdrawal/status/

Retrieve the current status and full details of a withdrawal by its ID. This is an alternative to the GET /withdrawal/{id}/ endpoint.

Authentication

Requires OAuth 2.0 authentication with read and write scopes.

Request Body

ParameterTypeRequiredDescription
withdrawal_idstring (UUID)YesThe unique identifier of the withdrawal

Example Request

curl -X POST {{BASE_URL}}/withdrawal/status/ \
  -H "Authorization: Bearer your_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "withdrawal_id": "550e8400-e29b-41d4-a716-446655440000"
  }'

Response

Success Response (200 OK)

Returns the full withdrawal detail object (same as Get Withdrawal):

{
  "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"
}

Error Responses

404 Not Found

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

Notes

  • This endpoint accepts POST with a JSON body containing the withdrawal_id
  • The response is identical to the GET /withdrawal/{id}/ endpoint
  • For response field descriptions, see the Get Withdrawal documentation