# Docs

- [Comece por aqui](/docs): Guia inicial para integrar com a API pública da Gandaya
- API Reference
  - [Listar pagamentos](/docs/api/get-public-v1-payments): Retorna uma lista paginada de pagamentos vinculados aos eventos autorizados pela chave de API.

**Permissão exigida:** `data`.

**Comportamento:**
- Pagamentos sem `amount` ou sem `paymentMethod` são excluídos automaticamente — `pagination.total` reflete apenas o que é retornado
- A profundidade de paginação está limitada a 10.000 registros (`page × limit ≤ 10000`)
- Intervalo `[startDate, endDate]` não pode exceder 365 dias
- Valores monetários são JSON numbers (float) preservando centavos

- **AI & LLMs**
- [llms.txt](/llms.txt)
- [llms-full.txt](/llms-full.txt)