# Mis beneficios (https://docs.loybox.com.ar/api-reference/mi-cuenta/mis-beneficios)



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

Beneficios que el usuario ya compró con sus puntos en este comercio y todavía
puede canjear.

El `client_benefit_code` de cada item es el código que el usuario presenta en el
comercio para canjearlo.

## 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 array de
[Beneficio canjeable](https://docs.loybox.com.ar/api-reference/objetos#beneficio-canjeable).

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

```json
// 200 OK
[
  {
    "client_benefit_code": 887766,
    "issue_date": "2026-08-24T13:05:00Z",
    "due_date": "2026-09-23T13:05:00Z",
    "used": false,
    "benefit": {
      "id": "b_9f2a",
      "type": "percentage_discount",
      "description": "20% de descuento en toda la tienda",
      "cost": 250,
      "expiration": "2026-12-31T23:59:59Z",
      "benefit_type": "normal",
      "color": "#f1a10d",
      "buy_limit": 0,
      "prize": null,
      "tiendanube_coupon": null
    }
  }
]
```

<Callout title="El código es el cupón">
  En una tienda online, el `client_benefit_code` es lo que el usuario pega en el
  checkout. Conviene mostrarlo grande y con un botón de copiar, y al lado el
  `due_date` para que sepa hasta cuándo lo puede usar.
</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`.                                      |