# Mi nivel (https://docs.loybox.com.ar/api-reference/mi-cuenta/nivel)



<Endpoint method="GET" path="/v1/me/level" auth="user-token" />

Nivel actual del usuario en este comercio, con su multiplicador de puntos, el
progreso acumulado y cuál es el próximo nivel.

## Headers [#headers]

<Fields>
  <Field name="X-Commerce-Id" type="integer" location="header" required="true">
    Id del comercio que integra la API. Todas las respuestas quedan limitadas a
    este comercio.
  </Field>
</Fields>

## Respuesta [#respuesta]

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

```bash
curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/me/level \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "X-Commerce-Id: 87"
```

```json
// 200 OK
{
  "name": "Plata",
  "rank": 2,
  "points_multiplier": 1.25,
  "icon_url": "https://cdn.loybox.com.ar/levels/plata.png",
  "reached_at": "2026-05-11T10:00:00Z",
  "expiration_date": "2027-05-11T10:00:00Z",
  "is_expired": false,
  "next_level": {
    "name": "Oro",
    "rank": 3,
    "threshold_type": "points",
    "threshold": 5000
  },
  "total_earned_points": 3120,
  "total_spent_amount": 312000,
  "total_consumptions_count": 48
}
```

## Cómo armar la barra de progreso [#cómo-armar-la-barra-de-progreso]

El progreso se calcula contra el acumulado histórico, no contra el saldo. Según
el `threshold_type` del próximo nivel:

| `threshold_type`  | Compararlo con        |
| ----------------- | --------------------- |
| Por puntos        | `total_earned_points` |
| Por monto gastado | `total_spent_amount`  |

<Callout type="info" title="Canjear no baja de nivel">
  El nivel se mide sobre el historial completo de la relación, así que gastar
  puntos baja el saldo pero nunca el nivel. Ver
  [Cómo suben de nivel](https://docs.loybox.com.ar/niveles/como-suben-de-nivel).
</Callout>

## Errores [#errores]

| Código | Cuándo                                                                                     |
| ------ | ------------------------------------------------------------------------------------------ |
| `401`  | El token de acceso falta, venció o no corresponde a un usuario final.                      |
| `404`  | El usuario todavía no tiene nivel asignado en este comercio, o el comercio no usa niveles. |
| `422`  | Falta el header `X-Commerce-Id`.                                                           |

<Callout type="warn" title="El 404 es el caso normal de un cliente nuevo">
  No lo trates como una falla. Cuando el usuario todavía no tiene nivel, o el
  comercio no usa niveles, corresponde **esconder la sección de niveles** en la UI,
  no mostrar un error.
</Callout>