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

# List Payouts

> Lista os saques solicitados pela loja, do mais recente para o mais antigo. O campo walletAddress é sempre mascarado (6 primeiros caracteres + ***). No sandbox retorna lista vazia.



## OpenAPI

````yaml /api-reference/openapi.yaml get /v1/payouts
openapi: 3.1.0
info:
  title: PurinCash API
  version: 1.0.0
servers:
  - url: https://api.purincash.com
    description: Produção
security:
  - bearerAuth: []
tags:
  - name: Cartao
    description: Pagamentos no cartao de credito.
  - name: Cobrancas
    description: Cobrancas PIX avulsas com valor livre.
  - name: Entregas
    description: Conteudo entregue automaticamente apos o pagamento.
  - name: Disputas
    description: Contestacoes (MED) e envio de evidencias.
  - name: Pagamentos
    description: Pagamentos PIX e LTC vinculados ou nao a um produto.
  - name: Saques
    description: Saques em PIX, LTC e USDT.
  - name: Produtos
    description: Produtos de cobranca criados pela API.
  - name: Sandbox
    description: Simulacao de pagamentos e saldo de teste.
  - name: Splits
    description: Cobrancas divididas entre varias contas.
  - name: Loja
    description: Produtos da loja do Discord (somente leitura).
  - name: Assinaturas
    description: PIX recorrente.
  - name: Carteira
    description: Saldo, retencoes e valores a liberar.
paths:
  /v1/payouts:
    get:
      tags:
        - Saques
      summary: List Payouts
      description: >-
        Lista os saques solicitados pela loja, do mais recente para o mais
        antigo. O campo walletAddress é sempre mascarado (6 primeiros caracteres
        + ***). No sandbox retorna lista vazia.
      operationId: listPayouts
      parameters:
        - name: limit
          in: query
          required: false
          description: Quantidade máxima de resultados (1-100).
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
        - name: status
          in: query
          required: false
          description: Filtra pelo status do saque.
          schema:
            type: string
            enum:
              - pendente
              - concluido
              - negado
      responses:
        '200':
          description: Lista de saques.
          content:
            application/json:
              schema:
                type: object
                properties:
                  payouts:
                    type: array
                    description: Saques solicitados, do mais recente para o mais antigo.
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Código do saque (igual a code).
                        code:
                          type: string
                          description: Código do saque (SAQ-API-...).
                        method:
                          type: string
                          enum:
                            - pix
                            - ltc
                          description: Método do saque.
                        amount:
                          type: number
                          description: Valor do saque em BRL.
                        cryptoAmount:
                          type:
                            - string
                            - 'null'
                          description: Quantidade em LTC (null para saques PIX).
                        walletAddress:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Chave/endereço mascarado (6 primeiros caracteres +
                            ***).
                        status:
                          type: string
                          description: Status do saque (pendente, concluido ou negado).
                        createdAt:
                          type: string
                          format: date-time
                          description: Data de criação do saque.
              example:
                payouts:
                  - id: SAQ-API-A1B2C3D4
                    code: SAQ-API-A1B2C3D4
                    method: pix
                    amount: 100
                    cryptoAmount: null
                    walletAddress: 12345***
                    status: pendente
                    createdAt: '2026-04-27T12:00:00.000Z'
        '401':
          description: Chave de API ausente ou inválida.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Mensagem de erro.
              example:
                error: Unauthorized
        '500':
          description: Erro interno.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Mensagem de erro.
              example:
                error: Internal error
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Chave de API gerada no dashboard da PurinCash (ps_live_ ou ps_test_).

````