---
title: "Query Withdrawal Records"
method: GET
path: "/v1/pay/wallet/withdrawals"
tags: ["wallet"]
---

# Query Withdrawal Records

`GET /v1/pay/wallet/withdrawals`

Query account withdrawal records list based on filter criteria.

## Query parameters

- `currency` string
- `withdraw_id` string
- `asset_class` 'SPOT' | 'PILOT'
- `withdraw_order_id` string
- `from` integer
- `to` integer
- `limit` integer
- `offset` integer

## Headers

- `X-GatePay-Certificate-ClientId` string, required
- `X-GatePay-Signature` string, required
- `X-GatePay-Timestamp` string, required
- `X-GatePay-Nonce` string, required

## Response `200`

Withdrawal records list

- WithdrawalRecord[]
  - `id` string — Transaction record ID.
  - `txid` string — Blockchain transaction hash
  - `block_number` string — Block number
  - `withdraw_order_id` string — Client order ID (max 32 chars, only allows numbers/letters/_/-/.).
  - `timestamp` string — Operation time (Unix timestamp in seconds).
  - `amount` string — Amount of currency.
  - `fee` string — Fee amount.
  - `currency` string — Currency name.
  - `address` string — Withdrawal address.
  - `fail_reason` string — Failure reason (only when status = CANCEL).
  - `timestamp2` string — Final status time: CANCEL - Cancellation time; DONE (block_number>0) - Success time.
  - `memo` string — Transaction memo/notes.
  - `status` string — Transaction status: DONE (Completed, block_number > 0 means on-chain confirmed), CANCEL (Cancelled), REQUEST (Requesting), MANUAL (Pending manual review), BCODE (Top-up code operation), EXTPEND (Sent awaiting confirmation), FAIL (On-chain failure awaiting confirmation), INVALID (Invalid order), VERIFY (Verifying), PROCES (Processing), PEND (Processing), DMOVE (Pending manual review), REVIEW (Under review).
  - `chain` string — Withdrawal chain name.

---

[API](https://skmtc.net/gate/apis/gatepay-withdrawal-wallet-api.md) · [All operations](https://skmtc.net/gate/apis/gatepay-withdrawal-wallet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gate/gatepay-withdrawal-wallet-api/versions/4feb16b0979e/schema)