---
title: "Listar saques"
method: GET
path: "/v1/cashouts"
tags: ["Saques"]
---

# Listar saques

`GET /v1/cashouts`

Retorna uma lista paginada de saques com suporte a filtros.

## Query parameters

- `page` integer
- `pageSize` integer
- `status` 'Pending' | 'Processing' | 'Completed' | 'Failed' | 'Rejected' | 'Cancelled'
- `startDate` string, date-time
- `endDate` string, date-time

## Response `200`

Lista de saques

- ListCashoutsResponse
  - `data` PaginatedCashouts, nullable
    - `items` CashoutListItem[]
      - `id` string, uuid
      - `amount` integer
      - `fee` integer
      - `netAmount` integer
      - `status` string
      - `pixKeyType` string, nullable
      - `pixKey` string, nullable
      - `endToEndId` string, nullable
      - `crypto` CashoutCryptoData, nullable — Destino de saque cripto via XGate. O endereço é sempre mascarado.
        - `walletAddress` string — Endereço da carteira mascarado.
        - `networkSymbol` string — Rede blockchain do saque.
        - `cryptoSymbol` string — Criptomoeda liquidada.
        - `transactionId` string, nullable — ID da transação retornado pela XGate, quando disponível.
      - `failureReason` string, nullable
      - `requestedAt` string, date-time
      - `completedAt` string, date-time, nullable
      - `createdAt` string, date-time
    - `page` integer
    - `pageSize` integer
    - `totalItems` integer
    - `totalPages` integer
    - `hasNextPage` boolean
    - `hasPreviousPage` boolean
  - `message` string, nullable
  - `error` ApiErrorResponse, nullable
    - `message` string — Mensagem de erro
    - `code` string — Codigo do erro

## Other responses

- `401` — Nao autorizado

---

[API](https://skmtc.net/safefy-pay/apis/safefy-pix-gateway.md) · [All operations](https://skmtc.net/safefy-pay/apis/safefy-pix-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safefy-pay/safefy-pix-gateway/revisions/57157be53ccc/schema)