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

# Paginação e filtros

> Percorra o catálogo sem sobrecarregar a API.

A listagem é paginada. Sem query, a API devolve a **página 1** com até **20** itens.

## Parâmetros

| Query   | Default | Limite         |
| ------- | ------- | -------------- |
| `page`  | `1`     | Inteiro ≥ 1    |
| `limit` | `20`    | Máximo **100** |

```bash theme={null}
curl "https://apiv3.usecorvex.com.br/api/v1/products?page=2&limit=50" \
  -H "Authorization: Bearer cvx_live_YOUR_API_KEY" \
  -H "X-Store-Id: 11111111-1111-4111-8111-111111111111"
```

## Resposta

```json theme={null}
{
  "success": true,
  "data": {
    "products": [],
    "pagination": {
      "page": 2,
      "limit": 50,
      "total": 180,
      "totalPages": 4
    }
  }
}
```

Use `totalPages` para parar. `limit` acima de 100 é recusado.

## Filtros

| Query                   | Efeito                                              |
| ----------------------- | --------------------------------------------------- |
| `status`                | `DRAFT`, `ACTIVE`, `PUBLISHED`, `INACTIVE` ou `all` |
| `name`                  | Nome contém o texto (sem diferenciar maiúsculas)    |
| `sku`                   | SKU do produto ou de uma variante                   |
| `minPrice` / `maxPrice` | Faixa de preço                                      |
| `updatedSince`          | ISO 8601 com fuso, ex. `2026-09-01T00:00:00-03:00`  |

Sem `status`, produtos `INACTIVE` **não** entram. Para incluir tudo, use `status=all`.

A listagem **não** traz `variants`. Para ver variantes, busque o produto por id.