---
title: "List withdrawals"
method: GET
path: "/v1/withdrawals"
tags: ["Withdrawals"]
---

# List withdrawals

`GET /v1/withdrawals`

Retrieve a paginated list of withdrawals with optional filters.

## Query parameters

- `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' — Possible withdrawal statuses.
- `method` 'PIX'
- `currency` 'BRL'
- `startDate` string, date-time
- `endDate` string, date-time
- `page` integer
- `limit` integer

## Response `200`

Withdrawals listed.

- object
  - `withdrawals` Withdrawal[]
    - `id` string, uuid
    - `txId` string — Transaction identifier: `WIT` followed by a millisecond timestamp and 5 uppercase alphanumerics, e.g. `WIT1746280868443K3F9Q`. Treat it as an opaque string.
    - `grossAmount` number
    - `feeAmount` number
    - `netAmount` number
    - `pixKey` string — The destination PIX key, masked. The full key is never returned by the API once the withdrawal is created.
    - `pixKeyType` string — Type of PIX key: `CPF`, `CNPJ`, `EMAIL`, `PHONE` or `EVP` (random key).
    - `status` 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' — Possible withdrawal statuses.
    - `isSandbox` boolean
    - `createdAt` string, date-time
    - `paymentMethod` 'PIX'
    - `currency` 'BRL'
    - `processedAt` string, date-time, nullable
    - `errorMessage` string, nullable — Human-readable failure message. Treat as opaque text and surface only to internal operators.
  - `pagination` Pagination
    - `page` integer
    - `limit` integer
    - `total` integer
    - `totalPages` integer

## Other responses

- `401` — Missing or invalid authentication token.
- `429` — Rate limit exceeded.

## Changes

- **2026-04-14** `74ad5da44cf9` — 4 breaking, 1 warning, 5 info
  - removed the enum value `BOLETO` from the `query` request parameter `method`
  - removed the enum value `CARD` from the `query` request parameter `method`
  - removed the enum value `CRYPTO_LTC` from the `query` request parameter `method`
  - removed the enum value `LTC` from the `query` request parameter `currency`
  - …6 more
- **2026-04-14** `c75657100757` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/yuvexpay/apis/yuvexpay-api/changes/v1/withdrawals/get.md)

---

[API](https://skmtc.dev/yuvexpay/apis/yuvexpay-api.md) · [All operations](https://skmtc.dev/yuvexpay/apis/yuvexpay-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/yuvexpay/yuvexpay-api/revisions/746526879975/schema)