# Consultar saque (/docs/conta-digital/endpoints/withdrawals/get_withdraw)

## GET /transactions/withdraw/{withdrawId}

`GET https://api.hub.payzu.com.br/api/v1/transactions/withdraw/{withdrawId}`

Escopo: `WITHDRAW_READ`. Devolve um saque ou um pagamento de Pix copia e cola, com o estado atual. Aceita o `id` do saque e o `withdrawId` dos webhooks.

### Path params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `withdrawId` | string | yes | Identificador do saque ou do pagamento de Pix copia e cola. |

### Responses

**200** Saque.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `id` | string | yes | Identificador do saque. A consulta aceita este `id` e o `withdrawId` dos webhooks. |
| `status` | string | yes | `REQUESTED`: pedido feito; o valor já saiu do saldo disponível. `CREATED`: registrado no banco. `APPROVED`: aprovado, a caminho. `CONFIRMED`: o dinheiro chegou. `FAILED`: não saiu, e o valor voltou ao saldo; pode vir de `REQUESTED`, `CREATED` ou `APPROVED`. — `REQUESTED`, `CREATED`, `APPROVED`, `CONFIRMED`, `FAILED` |
| `operation` | string | yes | `WITHDRAW`: saque para uma chave. `EXTERNAL_PAYMENT`: pagamento de Pix copia e cola. — `WITHDRAW`, `EXTERNAL_PAYMENT` |
| `amount` | integer | yes | Valor que chega ao destino. Em centavos. |
| `serviceFee` | integer | yes | Tarifa, somada por cima. Em centavos. |
| `totalDebited` | integer | yes | `amount + serviceFee`: o que sai da conta. Em centavos. |
| `destination` | object | yes | Destino do saque. |
| `destination.pixKey` | string | yes | Chave de destino, mascarada: CPF, e-mail e telefone saem mascarados; CNPJ e chave aleatória, legíveis. |
| `destination.pixKeyType` | string | null | yes | Tipo da chave, deduzido do formato. — `EVP`, `CNPJ`, `CPF`, `EMAIL`, `PHONE` |
| `comment` | string | null | yes | Texto enviado ao destinatário. |
| `e2e` | string | null | yes | End-to-end do Pix. `null` até o banco registrar. |
| `providerRejectedReason` | string | null | yes | Mensagem pronta para exibir, preenchida quando o banco recusou. |
| `callbackUrl` | string | null | yes | A `callbackUrl` enviada na criação. `null` quando não foi enviada. |
| `createdAt` | string | yes | Data e hora em ISO 8601, UTC. — format: date-time |
| `sentAt` | string | null | yes | Quando o banco registrou o saque. — format: date-time |
| `approvedAt` | string | null | yes | Quando o banco aprovou o saque. — format: date-time |
| `confirmedAt` | string | null | yes | Quando o dinheiro chegou ao destino. — format: date-time |
| `failedAt` | string | null | yes | Quando o saque falhou. `null` se não falhou. — format: date-time |

**401** Credencial ausente, inválida ou expirada.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**403** Sem permissão: escopo, IP ou operação desabilitada.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |

**404** Não encontrado, ou de outra conta.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `message` | string | yes | Descrição em português, pronta para exibir. Pode mudar a qualquer momento. |
| `code` | string | yes | Código estável do erro. É por ele que o seu sistema decide o que fazer. |
| `details` | object | no | Contexto estruturado do erro, quando existe. |