# Clientes

> Los compradores que han pagado a tu comercio: cómo listarlos, buscarlos por correo y ver todo lo que tienen asociado.

No se crean a mano. Un cliente aparece la primera vez que pagas algo a su nombre.

Cuando mandas `customer` al crear un cobro, Lane busca si ya existe uno con ese correo y lo reutiliza. Por eso el listado se llena solo.

### GET /v1/customers

Los clientes del entorno.

**Query**

| Campo | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `email` | texto | no | Busca por correo exacto. |
| `limit` | entero | no | Por defecto 25, máximo 100. |

### GET /v1/customers/{id}

Un cliente, con sus totales y los identificadores de lo que tiene asociado.

El detalle devuelve identificadores, no objetos completos: la respuesta se mantiene chica y expandes lo que te interese con el endpoint correspondiente.

**Buscar por correo**

```bash
curl "https://gxxazsplhgyezwxghrnn.supabase.co/functions/v1/blink-api/v1/customers?email=cliente@ejemplo.com" \
  -H "Authorization: Bearer sk_test_…"
```

_Respuesta 200_

```json
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "customer",
      "id": "44f1…",
      "email": "cliente@ejemplo.com",
      "name": "Ana Restrepo",
      "created_at": "2026-08-14T15:02:00.000Z"
    }
  ]
}
```