> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bukiopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Saques

> Lista os saques Pix da sua loja com situação, valores e datas.

Lista os saques Pix da sua loja. Use para conciliar e acompanhar o que ainda está em processamento.

**Método:** `GET /api/v1/wallet/activity?view=withdrawals`

**Autenticação:** Obrigatória — inclua o header `Authorization: Bearer sk_live_sua_api_key`. Requer o escopo `balance.read`.

## Parâmetros de query

<ParamField query="view" type="string" required>
  Use `withdrawals` para listar saques.
</ParamField>

<ParamField query="limit" default="20" type="number">
  Saques por página.
</ParamField>

<ParamField query="offset" default="0" type="number">
  Saques a pular, para paginação.
</ParamField>

## Exemplo de requisição

```bash theme={null}
curl -X GET 'https://api.bukiopay.com/api/v1/wallet/activity?view=withdrawals&limit=20' \
  --header 'Authorization: Bearer sk_live_sua_api_key'
```

## Resposta

```json theme={null}
{
  "transactions": [
    {
      "id": "7ef2b7a0-5cca-47be-bdc5-2eb1cb9fb75a",
      "type": "PIX_OUT",
      "status": "approved",
      "amount": 101,
      "description": "Saque Pix",
      "externalReference": "SAQ-API-6BA7B810",
      "createdAt": "2026-08-06T12:05:00.000Z",
      "withdrawal": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "status": "approved",
        "amount": 100,
        "feeAmount": 1,
        "totalAmount": 101,
        "currency": "BRL",
        "externalReference": "SAQ-API-6BA7B810",
        "createdAt": "2026-08-06T12:05:00.000Z",
        "processedAt": "2026-08-06T12:05:05.000Z"
      }
    }
  ],
  "pagination": { "limit": 20, "offset": 0, "total": 1 }
}
```

## Situações

| Status | Significado |
| - | - |
| `pending` | Aguardando aprovação |
| `processing` | Enviado, aguardando confirmação |
| `approved` | Concluído; o dinheiro chegou ao destino |
| `rejected` | Não concluído; o valor volta ao seu saldo |

<Note>
  Por segurança, a listagem não retorna a chave Pix, o titular nem os dados bancários do destino. Use o `externalReference` para conciliar com o seu registro.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.