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



A **client** is a person who joined the commerce's club. They have their own
`client_code`, point balance and history.

<Callout type="info" title="Client and member">
  The API resource is `client`, and that is the name used for fields and paths. In
  prose this documentation says "member", which is the product's term for the people
  in the club.
</Callout>

This section is read-only: it exists to show a member's state inside your system,
on the point-of-sale screen, in the online store's profile page, in a CRM. Points
move by recording [consumptions](https://docs.loybox.com.ar/api-reference/consumos) and
[redeeming benefits](https://docs.loybox.com.ar/api-reference/beneficios/canjear), not from here.

## The two benefit lists
There are two per-member benefit endpoints, and it is worth not mixing them up:

| Endpoint                                                                | What it returns                                                           |
| ----------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| [`/available-benefits`](https://docs.loybox.com.ar/api-reference/clientes/beneficios-disponibles) | The ones the member **can buy** with the points they hold                 |
| [`/benefits`](https://docs.loybox.com.ar/api-reference/clientes/beneficios-comprados)             | The ones they **already bought** and can still redeem, each with its code |

<Cards>
  <Card title="List clients" icon="Users" description="The commerce's full list, paginated." href="/api-reference/clientes/listar" />

  <Card title="Get a client" icon="User" description="One client by their code, with their point balance." href="/api-reference/clientes/obtener" />

  <Card title="Benefits they can buy" icon="Gift" description="The part of the catalog their points cover." href="/api-reference/clientes/beneficios-disponibles" />

  <Card title="Purchased benefits" icon="Tag" description="The ones already bought, each with its redemption code." href="/api-reference/clientes/beneficios-comprados" />
</Cards>

## Credential
The whole section goes from your server, with the
[commerce API key](https://docs.loybox.com.ar/api-reference/credenciales#api-key-del-comercio):

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

<Callout type="warn" title="It returns data about all your members">
  These endpoints expose the name, email and points of the people in the club. Do
  not call them from the frontend: if you need the user themselves to see their own
  data, that is what [My account](https://docs.loybox.com.ar/api-reference/mi-cuenta) is for, and it only
  shows their own.
</Callout>