# Listar Produtos
`GET /v1/products`
**Área:** Produtos

**Scopes necessários:** `products/read`

Lista todos os produtos cadastrados com suporte a filtros por status e paginação.

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `lastKey` | **sim** | base64 - optional |
| `status` | **sim** | active \| inactive - optional |
| `search` | **sim** | busca por nome - optional |
| `limit` | não | Quantidade de itens por página (default 50) - optional |

### Resposta 200 — 200

```json
{
  "items": [
    {
      "productId": "prod_xxx",
      "name": "Plano Premium"
    }
  ],
  "pagination": {
    "total": 10,
    "hasMore": false,
    "lastKey": null
  }
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/get-listar-produtos
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json