GET
https://dev.yimmit.com/api/v3/liquidity/withdraws/:idGet Withdraw By ID
GET api/v3/liquidity/withdraws/:id
Get details of specific Withdraw.
Parameters
| Name | Type | Mandatory | Description |
|---|---|---|---|
| id | INTEGER | YES | Unique 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 identifiercurrency_id: Currency codetype: Asset type (coin, fiat)blockchain_key: Blockchain network identifiertotal: Total withdrawal amountamount: Amount after deducting feesfee: Transaction fee amountblockchain_txid: Blockchain transaction ID (populated when withdrawal succeeds on blockchain, null for internal transfers or pending external withdrawals)rid: Recipient ID or wallet addressstate: Withdrawal state. Possible values:prepared(initial),canceled,accepted,skipped,to_reject,rejected,processing,under_review,succeed,deposited,failed,errored,confirming,lockedinternal_type: Type of internal transfer (address, platform_transfer, etc.) or null for externalconfirmations: Number of blockchain confirmationscreated_at: Request creation timestampupdated_at: Last update timestampdone_at: Completion timestamp (null if not yet completed)error_message: Error details if withdrawal failedtransaction_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"
}