---
title: "Get a withdrawal"
method: GET
path: "/v1/withdrawals/{withdrawalId}"
tags: ["Withdrawals"]
---

# Get a withdrawal

`GET /v1/withdrawals/{withdrawalId}`

Retrieve a single withdrawal by its ID.

## Path parameters

- `withdrawalId` string, uuid, required

## Response `200`

Withdrawal found.

- object
  - `withdrawal` 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.

## Other responses

- `401` — Missing or invalid authentication token.
- `404` — Resource not found.

## Changes

- **2026-04-14** `74ad5da44cf9` — 4 info
  - added the optional property `withdrawal/currency` to the response with the `200` status
  - added the optional property `withdrawal/errorMessage` to the response with the `200` status
  - added the optional property `withdrawal/paymentMethod` to the response with the `200` status
  - added the optional property `withdrawal/processedAt` to the response with the `200` status
- **2026-04-14** `c75657100757` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/yuvexpay/apis/yuvexpay-api/changes/v1/withdrawals/:withdrawalId/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.dev/yuvexpay/apis/yuvexpay-api/revisions/9d4ba1cc037c?raw)