Skip to main content
Version: 1.1.1
GEThttps://dev.yimmit.com/api/v3/liquidity/withdraws/:id
Auth required — send X-Auth-Apikey, X-Auth-Signature and X-Auth-Nonce. How to sign a request

Get Withdraw By ID

GET api/v3/liquidity/withdraws/:id

Get details of specific Withdraw.

Parameters

NameTypeMandatoryDescription
idINTEGERYESUnique identifier of the withdraw record. Used to fetch a specific withdraw request by its ID.

Responses

  • 200 Successful response

Returns a withdrawal object with details about the specific withdrawal request. The response can be either an external withdrawal (to a blockchain address) or an internal withdrawal (to another platform user).

Response Fields:

  • id: Unique withdrawal request identifier
  • currency_id: Currency code
  • type: Asset type (coin, fiat)
  • blockchain_key: Blockchain network identifier
  • total: Total withdrawal amount
  • amount: Amount after deducting fees
  • fee: Transaction fee amount
  • blockchain_txid: Blockchain transaction ID (populated when withdrawal succeeds on blockchain, null for internal transfers or pending external withdrawals)
  • rid: Recipient ID or wallet address
  • state: Withdrawal state. Possible values: prepared (initial), canceled, accepted, skipped, to_reject, rejected, processing, under_review, succeed, deposited, failed, errored, confirming, locked
  • internal_type: Type of internal transfer (address, platform_transfer, etc.) or null for external
  • confirmations: Number of blockchain confirmations
  • created_at: Request creation timestamp
  • updated_at: Last update timestamp
  • done_at: Completion timestamp (null if not yet completed)
  • error_message: Error details if withdrawal failed
  • transaction_type: Either "external" or "internal"

Example

{
"id": 39,
"currency_id": "usdt",
"type": "coin",
"blockchain_key": "eth-testnet",
"total": "10.0",
"amount": "9.0",
"fee": "1.0",
"blockchain_txid": "0x82423383d00812c6d59689ce47fe9dbabe8e0f6b8037aeac3ebd298dd5f666f5",
"rid": "0x76dcd3dafb5f7229542f0580d9c5a1612486a42b",
"state": "succeed",
"internal_type": null,
"confirmations": 0,
"error_message": null,
"transaction_type": "external",
"created_at": "2026-01-12T16:55:43Z",
"updated_at": "2026-01-12T16:57:22Z",
"done_at": "2026-01-12T16:57:22Z"
}