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

# Paginação

> Paginação por cursor.

Endpoints de listagem retornam um envelope de lista e usam paginação por cursor.
Use `limit`, `starting_after` e `ending_before` para navegar pelos resultados.

<RequestExample>
  ```bash cURL theme={}
  curl "https://api.chargefy.io/v1/customers?limit=20&starting_after=cus_123" \
    -H "Authorization: Bearer {{API_KEY}}"
  ```
</RequestExample>

## Parâmetros

<ParamField query="limit" type="integer">
  Quantidade máxima de itens retornados.
</ParamField>

<ParamField query="starting_after" type="string">
  Cursor para buscar itens depois do objeto informado.
</ParamField>

<ParamField query="ending_before" type="string">
  Cursor para buscar itens antes do objeto informado.
</ParamField>

## Resposta

Listagens sempre retornam `object: "list"`, a `url` relativa do endpoint,
`has_more` e o array `data`.

<ResponseExample>
  ```json theme={}
  {
    "object": "list",
    "data": [
      {
        "id": "cus_123",
        "object": "customer",
        "email": "cliente@example.com"
      }
    ],
    "has_more": true,
    "url": "/v1/customers"
  }
  ```
</ResponseExample>

<ResponseField name="object" type="string">
  Sempre `list`.
</ResponseField>

<ResponseField name="data" type="array">
  Lista de objetos públicos do recurso consultado.
</ResponseField>

<ResponseField name="has_more" type="boolean">
  `true` quando existe uma próxima página.
</ResponseField>

<ResponseField name="url" type="string">
  URL relativa do endpoint listado.
</ResponseField>

## Filtros

Filtros variam por recurso e são documentados na página de cada endpoint. Quando
um endpoint aceita filtros de intervalo, use operadores como `[gte]`, `[gt]`,
`[lte]` e `[lt]`.

Exemplo:

```bash theme={}
GET /v1/payment-intents?created_at[gte]=2026-05-01T00:00:00Z
```