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



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

Todo lo que necesita el frontend en el primer render: los datos del usuario, sus
puntos y adhesión en el programa del comercio indicado en `X-Commerce-Id`, los
datos de marca del comercio (nombre, logo, color, rubro) y los puntos que están
por vencer.

Es la llamada con la que arranca la app. No hace falta pedir los datos del
comercio aparte: vienen dentro.

## 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 [Mi cuenta](https://docs.loybox.com.ar/api-reference/objetos#mi-cuenta).

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

```json
// 200 OK
{
  "username": "Ana Pérez",
  "email": "ana@example.com",
  "phone": null,
  "points": 340,
  "subscribed": true,
  "commerce": {
    "id": 87,
    "name": "Tienda Central",
    "logo": "https://cdn.loybox.com.ar/logos/87.png",
    "color": "#f1a10d",
    "category_name": "Tienda de comics",
    "currency": "ARS"
  },
  "points_expiration": {
    "points": 120,
    "expiration_date": "2026-09-30T23:59:59Z",
    "days_left": 37,
    "months_left": 1,
    "mode": "accumulated"
  }
}
```

Qué hacer con cada pieza:

| Campo               | Para qué                                                                                                        |
| ------------------- | --------------------------------------------------------------------------------------------------------------- |
| `points`            | El saldo grande de la pantalla. Es con lo que se compara el `cost` de cada beneficio.                           |
| `subscribed`        | Si viene en `false`, mostrá el llamado a [adherirse](https://docs.loybox.com.ar/api-reference/mi-cuenta/adherirme) en lugar del catálogo. |
| `commerce`          | Logo, nombre y color para pintar la marca del programa.                                                         |
| `points_expiration` | El aviso de "te vencen X puntos en Y días".                                                                     |

<Callout type="info" title="Cuando los puntos no vencen">
  `points_expiration` no viene en `null`: viene con `mode: "none"` y `points: 0`.
  Chequeá el `mode` antes de mostrar el aviso de vencimiento.
</Callout>

## Errores [#errores]

| Código | Cuándo                                                                |
| ------ | --------------------------------------------------------------------- |
| `401`  | El token de acceso falta, venció o no corresponde a un usuario final. |
| `422`  | Falta el header `X-Commerce-Id`.                                      |