# Consultar saque

**Área:** Saques

Com esta funcionalidade você consulta o status de um saque específico pelo `withdrawalId`, da sua _master account_ ou de uma subconta associada a ela.

`GET /v1/wallet/withdrawals/:withdrawalId`

**Base URL Produção:** `https://api.validapay.com.br`  
**Base URL Sandbox:** `https://sandbox.validapay.com.br`

**Scopes necessários:** `wallet/read`

Use esta rota para acompanhar um saque que retornou `PROCESSING` no `POST /v1/wallet/withdraw`: consulte até o `status` mudar para `CONFIRMED` ou `ERROR`. A resposta tem o mesmo formato de um item de `GET /v1/wallet/withdrawals`.

**Status do saque**

- `PROCESSING`: PIX enviado, aguardando a confirmação da liquidação.
- `CONFIRMED`: PIX liquidado na conta de destino.
- `ERROR`: o PIX foi aceito para envio, mas a liquidação falhou.

> ⚠️ **Atenção:** para consultar o saque de uma subconta, envie o número dela em `accountId`. Sem `accountId`, a busca é feita só na conta do token, e um saque de outra conta responde 404 `WITHDRAWAL_NOT_FOUND`.

Case de uso:

_Como integrador, quero consultar um saque pelo seu identificador, para saber se o PIX já foi liquidado sem precisar percorrer o histórico de saques._

### Path parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `withdrawalId` | **sim** | Identificador do saque, o mesmo withdrawalId retornado no POST /v1/wallet/withdraw |

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `accountId` | não | Número da subconta dona do saque. Omitido, consulta a própria conta do token |

### Resposta 200: Sucesso

```json
{
    "withdrawalId": "wdr_1792851006000_ab12cd34e", 
    "accountId": "258965356", 
    "amount": 150.00, 
    "feeAmount": 0.47, 
    "feeDeduction": { 
        "status": "COMPLETED", 
        "amount": 0.47, 
        "settledFromDebt": false, 
        "timestamp": "2026-10-24T14:16:52.120Z" 
    },
    "status": "CONFIRMED", 
    "pixKey": "12345678000190", 
    "pixKeyType": "CNPJ", 
    "documentNumber": "12345678000190", 
    "endToEndId": "E13935893202610241416abcdef12345", 
    "transactionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", 
    "creditParty": { 
        "bank": "18236120", 
        "key": "12345678000190", 
        "branch": "0001", 
        "account": "1234567", 
        "name": "EMPRESA EXEMPLO LTDA", 
        "accountType": "CACC" 
    },
    "createdAt": "2026-10-24T14:16:46.000Z", 
    "updatedAt": "2026-10-24T14:16:52.120Z" 
}
```

#### Campos da resposta

| Campo | Descrição |
|---|---|
| `withdrawalId` | Identificador do saque, o mesmo retornado no POST /v1/wallet/withdraw |
| `accountId` | Conta de onde o saldo saiu |
| `amount` | Valor sacado, em reais |
| `feeAmount` | Tarifa do saque, em reais |
| `feeDeduction` | Débito da tarifa no saldo. null enquanto o saque não é confirmado |
| `feeDeduction.status` | COMPLETED: tarifa debitada. FAILED: saldo insuficiente no momento; a tarifa fica pendente e é cobrada depois |
| `feeDeduction.amount` | Valor debitado, em reais |
| `feeDeduction.settledFromDebt` | true quando a tarifa pendente foi quitada depois |
| `feeDeduction.timestamp` | Momento do débito da tarifa |
| `status` | PROCESSING, CONFIRMED ou ERROR |
| `pixKey` | Chave Pix de destino |
| `pixKeyType` | Tipo da chave Pix |
| `documentNumber` | CPF/CNPJ do titular da conta que sacou |
| `endToEndId` | Identificador do PIX no arranjo, para conciliação com o banco de destino |
| `transactionId` | Identificador da transação do PIX |
| `creditParty` | Conta de destino, como consta no DICT |
| `creditParty.bank` | ISPB da instituição de destino |
| `creditParty.key` | Chave Pix de destino |
| `creditParty.branch` | Agência |
| `creditParty.account` | Conta |
| `creditParty.name` | Titular da conta de destino |
| `creditParty.accountType` | Tipo da conta de destino |
| `createdAt` | Criação do saque |
| `updatedAt` | Última atualização do status |

### Resposta 404: Saque não encontrado

```json
{
    "error": {
        "message": "Saque não encontrado",
        "code": "WITHDRAWAL_NOT_FOUND",
        "details": null,
        "timestamp": "2026-10-24T14:19:02.341Z"
    }
}
```


### Resposta 404: Subconta não encontrada

```json
{
    "error": {
        "message": "Subconta 499999999 nao encontrada",
        "code": "SUBACCOUNT_NOT_FOUND",
        "details": null,
        "timestamp": "2026-10-24T14:20:11.512Z"
    }
}
```


### Resposta 401: Subconta de outra master account

```json
{
    "error": {
        "message": "Subconta 499999999 nao pertence a esta conta master",
        "code": "UNAUTHORIZED_SUBACCOUNT",
        "details": null,
        "timestamp": "2026-10-24T14:21:03.877Z"
    }
}
```


---

Página: https://docs.validapay.com.br/referencia/get-consultar-saque  
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json