> ## 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 cobranças PIX

> Retorna a listagem de cobranças com filtros de status e paginação.

<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>

Lista todas as cobranças emitidas pela sua conta com suporte a paginação e filtros por status.

### Parâmetros de Consulta (Query)

<ParamField query="status" type="string">
  Filtra cobranças por status: `waiting_payment`, `paid`, `expired`, `cancelled`.
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Quantidade máxima de registros retornados (máximo: 100).
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Deslocamento de registros para paginação.
</ParamField>

### Resposta de Sucesso

<ResponseField name="data" type="array">
  Lista de cobranças cadastradas.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.kavropay.online/v1/charges?status=paid&limit=20" \
    -H "Authorization: Bearer sk_live_SUA_CHAVE_AQUI"
  ```

  ```javascript Node.js theme={null}
  const res = await fetch('https://api.kavropay.online/v1/charges?status=paid&limit=20', {
    headers: { 'Authorization': 'Bearer sk_live_SUA_CHAVE_AQUI' }
  });
  const data = await res.json();
  console.log(data);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "data": [
      {
        "id": "PAY8829F1A4BC",
        "status": "paid",
        "amount": 100.00,
        "paid_at": "2026-09-30T09:32:15.000Z",
        "created_at": "2026-09-30T09:30:00.000Z"
      }
    ],
    "total": 1
  }
  ```
</ResponseExample>