---
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
    - `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, RANDOM).
    - `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.

---

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