# Listar clientes

`GET /api/v1/billing/clientes`

Listado de clientes con paginación basada en cursor.

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

## Parámetros

| Nombre | En | Tipo | Requerido | Descripción |
| --- | --- | --- | --- | --- |
| `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/clientes" \
  -H "X-Api-Key: $SIMPLO_API_KEY"
```

## Respuestas

### 200 — Lista de clientes

Schema: `ClienteListResponse`

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

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

Schema: `ErrorResponse`