---
title: "Get withdrawal queue entries for an account"
method: GET
path: "/api/v1/withdraw_queue"
tags: ["User"]
---

# Get withdrawal queue entries for an account

`GET /api/v1/withdraw_queue`

Returns all withdrawal queue entries for the specified account,
optionally filtered by status.

## Query parameters

- `account` string, required
- `status` 'Queued' | 'Processed' | 'Cancelled'
- `limit` integer
- `offset` integer

## Response `200`

Withdraw queue entries retrieved successfully

- PaginatedResponseWithdrawQueueEntryDto
  - `items` object[], required — The items in the current page
    - `cancel_reason` union — Cancel reason for a withdrawal request. Serializes as a flat string for all variants (including Unknown).
      - 'CancelledByUser'
      - 'InsufficientWithdrawableBalance'
      - 'DepositCheckFailed'
      - object
        - `Unknown` string, required
    - `fungible_amount` number, double, required — Requested withdrawal amount, normalized by collateral decimals.
    - `market` string, nullable — The market address. Absent for non-market (cross-margin) withdrawals.
    - `processed_amount` number, double, required — Amount actually withdrawn. Equals `fungible_amount` for Processed entries, 0 otherwise.
    - `queued_at_ms` integer, nullable — Timestamp when the withdrawal was originally queued. Always present for Queued entries. For Processed/Cancelled entries, enriched from the corresponding Queued row. HTTP responses enrich via same-page lookup + DB backfill; WebSocket updates only enrich from the same batch, so this may be absent.
    - `recipient` string, nullable — The intended recipient address. The on-chain CancelledEvent omits this field, so it is enriched from the corresponding Queued row. HTTP responses enrich via same-page lookup + DB backfill; WebSocket updates only enrich from the same batch.
    - `request_id` string, required
    - `status` 'Queued' | 'Processed' | 'Cancelled', required
    - `timestamp_ms` integer, required — Timestamp of this specific event. For Processed entries this is the settlement time; for Cancelled entries the cancellation time. See `queued_at_ms` for the original queue time.
    - `transaction_version` integer, required
    - `user` string, required
  - `total_count` integer, nullable — The total number of items across all pages. Optional: history endpoints omit this field to avoid expensive COUNT(*) queries.

## Other responses

- `500` — Database error

---

[API](https://skmtc.net/decibel/apis/decibel-trading-api.md) · [All operations](https://skmtc.net/decibel/apis/decibel-trading-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decibel/decibel-trading-api/versions/37a02083ff59/schema)