# Obtener un cliente (https://docs.loybox.com.ar/api-reference/clientes/obtener)



<Endpoint method="GET" path="/v1/clients/{client_code}" auth="api-key" />

Busca un cliente por su código. El `client_code` es el número que tiene cada
persona registrada en Loybox: es el que el cliente da en la caja y el que se usa
para [registrar un consumo](https://docs.loybox.com.ar/api-reference/consumos/crear-por-codigo).

## Parámetros [#parámetros]

<Fields>
  <Field name="client_code" type="string" location="path" required="true">
    El código del cliente.
  </Field>
</Fields>

## Respuesta [#respuesta]

Un objeto [Cliente](https://docs.loybox.com.ar/api-reference/objetos#cliente).

```bash
curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/clients/12345 \
  -H "Authorization: Bearer $LOYBOX_API_KEY"
```

```json
// 200 OK
{
  "code": 12345,
  "username": "Ana Pérez",
  "email": "ana@example.com",
  "points": 340
}
```

El campo `points` es el saldo disponible: puntos ganados vigentes menos puntos
canjeados. Los puntos vencidos no cuentan. Ver
[Saldo](https://docs.loybox.com.ar/referencia-tecnica#saldo).

## Errores [#errores]

| Código | Cuándo                                |
| ------ | ------------------------------------- |
| `404`  | El cliente no existe.                 |
| `422`  | El código no tiene un formato válido. |