# Clientes (https://docs.loybox.com.ar/api-reference/clientes)



Un **cliente** es una persona sumada al club del comercio. Tiene un
`client_code`, un saldo de puntos y un historial propios.

Esta sección es de sólo lectura: sirve para mostrar el estado de un cliente en
tu sistema: en la pantalla de caja, en el perfil de la tienda online, en un
CRM. Los puntos se mueven registrando [consumos](https://docs.loybox.com.ar/api-reference/consumos) y
[canjeando beneficios](https://docs.loybox.com.ar/api-reference/beneficios/canjear), no desde acá.

## Los dos listados de beneficios [#los-dos-listados-de-beneficios]

Hay dos endpoints de beneficios por cliente y conviene no confundirlos:

| Endpoint                                                                | Qué trae                                                              |
| ----------------------------------------------------------------------- | --------------------------------------------------------------------- |
| [`/available-benefits`](https://docs.loybox.com.ar/api-reference/clientes/beneficios-disponibles) | Los que el cliente **puede comprar** con los puntos que tiene         |
| [`/benefits`](https://docs.loybox.com.ar/api-reference/clientes/beneficios-comprados)             | Los que **ya compró** y todavía puede canjear, cada uno con su código |

<Cards>
  <Card title="Listar clientes" icon="Users" description="El listado completo del comercio, paginado." href="/api-reference/clientes/listar" />

  <Card title="Obtener un cliente" icon="User" description="Un cliente por su código, con su saldo de puntos." href="/api-reference/clientes/obtener" />

  <Card title="Beneficios que puede comprar" icon="Gift" description="El catálogo que le alcanza con los puntos que tiene." href="/api-reference/clientes/beneficios-disponibles" />

  <Card title="Beneficios comprados" icon="Tag" description="Los que ya compró, con el código de canje de cada uno." href="/api-reference/clientes/beneficios-comprados" />
</Cards>

## Credencial [#credencial]

Toda la sección va desde tu servidor, con la
[API key del comercio](https://docs.loybox.com.ar/api-reference/credenciales#api-key-del-comercio):

```
Authorization: Bearer {api-key}
```

<Callout type="warn" title="Devuelve datos de todos tus clientes">
  Estos endpoints exponen nombre, email y puntos de las personas del club. No los
  llames desde el frontend: si necesitás que el propio usuario vea sus datos, para
  eso está [Mi cuenta](https://docs.loybox.com.ar/api-reference/mi-cuenta), que sólo muestra lo suyo.
</Callout>