List merchant withdrawals
Returns paginated list of merchant withdrawals with optional status filter.
curl -X GET "https://api.example.com/v1/api/v1/withdrawals/?page=25&per_page=25&status=null&order=desc" \
-H "Content-Type: application/json" \
-H "X-Api-Key: YOUR_API_KEY"
import requests
import json
url = "https://api.example.com/v1/api/v1/withdrawals/?page=25&per_page=25&status=null&order=desc"
headers = {
"Content-Type": "application/json",
"X-Api-Key": "YOUR_API_KEY"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://api.example.com/v1/api/v1/withdrawals/?page=25&per_page=25&status=null&order=desc", {
method: "GET",
headers: {
"Content-Type": "application/json",
"X-Api-Key": "YOUR_API_KEY"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
)
func main() {
req, err := http.NewRequest("GET", "https://api.example.com/v1/api/v1/withdrawals/?page=25&per_page=25&status=null&order=desc", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-Api-Key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api.example.com/v1/api/v1/withdrawals/?page=25&per_page=25&status=null&order=desc')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['X-Api-Key'] = 'YOUR_API_KEY'
response = http.request(request)
puts response.body
{
"data": [
{
"address": "TXqZ5nM3YwK8vR2pL7dFcJ6hG9bE4sA1uN",
"amount": "150.00",
"amount_to_receive": "149.00",
"created_at": "2026-02-26T14:30:00+00:00",
"external_tx_id": "a1b2c3d4e5f6...",
"network_fee": "1.00",
"processed_at": "2026-02-26T14:35:00+00:00",
"status": "completed",
"updated_at": "2026-02-26T14:35:00+00:00",
"withdraw_uuid": "b3f1a2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
"withdrawal_method_id": 1
}
],
"page": 1,
"per_page": 20,
"successful": true,
"total": 42,
"total_pages": 3
}
{
"successful": false,
"request_id": "a1b2c3d4-...",
"error": {
"code": "API_KEY_MISSING",
"message": "Missing X-Api-Key header"
}
}
{
"successful": false,
"request_id": "a1b2c3d4-...",
"error": {
"code": "API_KEY_INVALID",
"message": "Invalid or inactive API key"
}
}
{
"successful": false,
"request_id": "a1b2c3d4-...",
"error": {
"code": "WITHDRAWALS_NOT_FOUND",
"message": "No withdrawals found for this merchant"
}
}
{
"error": "Unprocessable Entity",
"message": "The request was well-formed but contains semantic errors",
"code": 422,
"details": [
{
"field": "password",
"message": "Password must be at least 8 characters long"
}
]
}
/api/v1/withdrawals/
Page number
Items per page
Filter by withdrawal status
Sort order by created_at
Request Preview
Response
Response will appear here after sending the request
Authentication
API Key for authentication. Merchant API Key.
Query Parameters
Page number
Items per page
Filter by withdrawal status
Responses
Whether the request was successful
Current page number
Items per page
Total withdrawals matching the filter
Total pages
Unique withdrawal identifier (UUID)
ID of the withdrawal method used
Destination wallet address
Optional memo/tag (if required by network)
Requested withdrawal amount in USDT
Network fee deducted from withdrawal
Final amount after fee deduction
Withdrawal status: pending, processing, completed, failed, cancelled
Detailed sub-status if available
Blockchain transaction hash (available after broadcast)
Creation timestamp in ISO 8601 UTC
Last update timestamp in ISO 8601 UTC
Completion timestamp in ISO 8601 UTC
Unique request ID for debugging
Machine-readable error code
Human-readable description
Extra context (varies by error)
Unique request ID for debugging
Machine-readable error code
Human-readable description
Extra context (varies by error)
Unique request ID for debugging
Machine-readable error code
Human-readable description
Extra context (varies by error)
Last updated Feb 26, 2026
Built with Documentation.AI