Seção 10

Paginação e Filtros

As listagens usam limit e offset:

Parâmetro	Padrão	Máximo
`limit`	`20`	`100`
`offset`	`0`	—

Formato da resposta:

{
  "items": [ ],
  "total": 134,
  "limit": 20,
  "offset": 0
}

Para a próxima página, some limit ao offset até alcançar total.

Parâmetro	Exemplo	Descrição
`status`	`PAID`	`PENDING`, `PAID`, `FAILED`, `CANCELED`, `REFUNDED`, `REQUIRES_ACTION`
`payment_method`	`PIX`	`PIX`, `BOLETO`, `CARD`
`due_date_from`	`2026-10-01`	Vencimento a partir de
`due_date_to`	`2026-10-31`	Vencimento até
`subscription_id`	`12`	Cobranças de uma assinatura

curl "https://api.gaudpay.com.br/payments?status=PAID&payment_method=PIX&limit=50" \
  -H "Authorization: Bearer $GAUDPAY_TOKEN"

GET /customers?q=maria busca por nome ou documento.