Clientes

Listar clientes

GET /api/v1/customers

Parámetros:

Nombre	Tipo	Descripción
cursor	string	Cursor de paginación
limit	int	Items por página (default 25)
filter[status]	string	active, disabled
q	string	Busca en email, nombre, teléfono
sort	string	-created_at, email, first_name

Respuesta 200:

{
  "data": [
    {
      "id": "uuid",
      "email": "[email protected]",
      "first_name": "Juan",
      "last_name": "Pérez",
      "phone": "+51987654321",
      "accepts_marketing": true,
      "tags": ["vip", "wholesale"],
      "status": "active",
      "created_at": "2026-04-08T12:00:00Z"
    }
  ]
}

---

Crear cliente

POST /api/v1/customers

{
  "email": "[email protected]",
  "first_name": "Juan",
  "last_name": "Pérez",
  "phone": "+51987654321",
  "accepts_marketing": true,
  "tags": ["vip"]
}

Respuesta 201: objeto Customer completo.

---

Direcciones

Listar direcciones

GET /api/v1/customers/:id/addresses

Agregar dirección

POST /api/v1/customers/:id/addresses

{
  "first_name": "Juan",
  "last_name": "Pérez",
  "company": "Mi Empresa SAC",
  "address1": "Av. Javier Prado 123",
  "address2": "Piso 5",
  "city": "Lima",
  "province": "Lima",
  "country_code": "PE",
  "zip": "15001",
  "phone": "+51987654321",
  "is_default": true
}

Actualizar dirección

PUT /api/v1/customers/:id/addresses/:address_id

Eliminar dirección

DELETE /api/v1/customers/:id/addresses/:address_id

---

Órdenes del cliente

GET /api/v1/customers/:id/orders

Lista las órdenes del cliente con los mismos parámetros que el endpoint de órdenes.