# Listar saques (/docs/conta-digital/endpoints/withdrawals/get_withdraws)

## GET /transactions/withdraw

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

Escopo: `WITHDRAW_READ`. Devolve os saques da conta, com os pagamentos de Pix copia e cola, do mais recente para o mais antigo, paginados por cursor.

### Query params

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `limit` | integer | no | Itens por página, de 1 a 100. — minimum: 1; maximum: 100; default: 20 |
| `cursor` | string | no | `nextCursor` da página anterior. |
| `status` | string | no | Estado do saque. — `REQUESTED`, `CREATED`, `APPROVED`, `CONFIRMED`, `FAILED` |
| `dateFrom` | string | no | Início do período, pela data de criação. ISO 8601 ou `AAAA-MM-DD`; data sem hora vale o dia inteiro no horário de Brasília. |
| `dateTo` | string | no | Fim do período, pela data de criação. ISO 8601 ou `AAAA-MM-DD`; data sem hora vale o dia inteiro no horário de Brasília. |

### Responses

**200** Página de saques.

| Field | Type | Required | Details |
| --- | --- | --- | --- |
| `data` | object[] | yes | Saques e pagamentos de Pix copia e cola da conta, da mais recente para a mais antiga. |
| `data.id` | string | yes | Identificador do saque. A consulta aceita este `id` e o `withdrawId` dos webhooks. |
| `data.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` |
| `data.operation` | string | yes | `WITHDRAW`: saque para uma chave. `EXTERNAL_PAYMENT`: pagamento de Pix copia e cola. — `WITHDRAW`, `EXTERNAL_PAYMENT` |
| `data.amount` | integer | yes | Valor que chega ao destino. Em centavos. |
| `data.serviceFee` | integer | yes | Tarifa, somada por cima. Em centavos. |
| `data.totalDebited` | integer | yes | `amount + serviceFee`: o que sai da conta. Em centavos. |
| `data.destination` | object | yes | Destino do saque. |
| `data.destination.pixKey` | string | yes | Chave de destino, mascarada: CPF, e-mail e telefone saem mascarados; CNPJ e chave aleatória, legíveis. |
| `data.destination.pixKeyType` | string | null | yes | Tipo da chave, deduzido do formato. — `EVP`, `CNPJ`, `CPF`, `EMAIL`, `PHONE` |
| `data.comment` | string | null | yes | Texto enviado ao destinatário. |
| `data.e2e` | string | null | yes | End-to-end do Pix. `null` até o banco registrar. |
| `data.createdAt` | string | yes | Data e hora em ISO 8601, UTC. — format: date-time |
| `data.confirmedAt` | string | null | yes | Quando o dinheiro chegou ao destino. — format: date-time |
| `nextCursor` | string | no | Cursor da próxima página. Ausente na última página. |

**400** Requisição inválida.

| 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. |

**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. |