# Listar productos

`GET /api/v1/billing/productos`

Listado de productos con paginación basada en cursor. Soporta filtro por categoría.

- Autenticación: header `X-Api-Key: sk_simplo_...` (o `Authorization: Bearer <jwt>` para sesiones de la plataforma).
- operationId: `listProductos` — contrato completo en https://docs.simplo.cl/openapi.yaml
- Versión HTML: https://docs.simplo.cl/api/operations/listproductos/

## Parámetros

| Nombre | En | Tipo | Requerido | Descripción |
| --- | --- | --- | --- | --- |
| `categoria` | query | string | no | Filtrar por categoría |
| `cursor` | query | string | no | Cursor de paginación retornado en `next_cursor` de la página anterior |
| `limit` | query | integer | no | Cantidad máxima de resultados por página |

## Ejemplo (curl)

```sh
curl -X GET "https://api.simplo.cl/api/v1/billing/productos" \
  -H "X-Api-Key: $SIMPLO_API_KEY"
```

## Respuestas

### 200 — Lista de productos

Schema: `ProductoListResponse`

| Campo | Tipo | Requerido | Descripción |
| --- | --- | --- | --- |
| `data` | ProductoResponse[] | no |  |
| `next_cursor` | string | no | Cursor para la siguiente página |

### 401 — Token o API key inválido o ausente

Schema: `ErrorResponse`