# Buscar clientes por nombre o RUT

`GET /api/v1/billing/clientes/search`

Búsqueda rápida de clientes por razón social o RUT.

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

## Parámetros

| Nombre | En | Tipo | Requerido | Descripción |
| --- | --- | --- | --- | --- |
| `q` | query | string | sí | Texto de búsqueda (nombre o RUT) |
| `limit` | query | integer | no | Cantidad máxima de resultados |

## Ejemplo (curl)

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

## Respuestas

### 200 — Resultados de búsqueda

Tipo: ClienteResponse[]

### 400 — Parámetro q requerido

Schema: `ErrorResponse`

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

Schema: `ErrorResponse`