# Recompensas del programa (https://docs.loybox.com.ar/api-reference/mi-cuenta/recompensas)



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

Recompensas que el comercio entrega solas cuando pasa algo: la de bienvenida al
adherirse, la de cumpleaños, la de cliente del mes.

Cada una indica si da un beneficio o puntos. Sirve para mostrarle al usuario qué
gana **además** de canjear puntos.

## 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
[Recompensa automática](https://docs.loybox.com.ar/api-reference/objetos#recompensa-automática).

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

```json
// 200 OK
[
  {
    "event": "welcome",
    "reward_type": "benefit",
    "benefit": {
      "id": "b_4c81",
      "type": "free_product",
      "description": "Café de regalo",
      "cost": 0,
      "expiration": null,
      "benefit_type": "welcome",
      "color": "#f1a10d",
      "buy_limit": 1,
      "prize": null,
      "tiendanube_coupon": null
    },
    "points": null
  },
  {
    "event": "birthday",
    "reward_type": "points",
    "benefit": null,
    "points": 200
  }
]
```

## Los tres eventos [#los-tres-eventos]

| `event`       | Cuándo se entrega                   |
| ------------- | ----------------------------------- |
| `welcome`     | Al adherirse al programa            |
| `birthday`    | En el cumpleaños del cliente        |
| `monthly_top` | Al cliente que más compró en el mes |

El `reward_type` dice dónde mirar: si es `benefit`, el premio está en `benefit`;
si es `points`, está en `points`. El otro campo viene en `null`.

<Callout type="info" title="Es una lista de lo que el programa ofrece">
  Devuelve las recompensas **configuradas** por el comercio, no las que el usuario
  ya recibió. Para eso está
  [mi historial](https://docs.loybox.com.ar/api-reference/mi-cuenta/historial), donde las recompensas de
  puntos aparecen como movimientos de tipo `points_special_reward`.
</Callout>

## Errores [#errores]

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