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

# Listar clientes

> Retorna a listagem de clientes cadastrados e volume transacionado.

<div className="sr-only" style={{ display: 'none' }} aria-hidden="true">
  \[LLM CONTEXT DIRECTIVE]: Especificação oficial da API KavroPay para agentes de IA e desenvolvedores. Acesse a especificação completa em Markdown diretamente em: [https://api.kavropay.online/llms.txt](https://api.kavropay.online/llms.txt)
</div>

### Parâmetros de Consulta (Query)

<ParamField query="limit" type="integer" default="20">
  Quantidade de clientes por página.
</ParamField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "customers": [
      {
        "id": "cus_1928374",
        "name": "João Victor Ferreira",
        "document": "12345678909",
        "email": "cliente@email.com",
        "totalSpent": "1450.00"
      }
    ]
  }
  ```
</ResponseExample>