# Beneficios que puedo comprar (https://docs.loybox.com.ar/api-reference/mi-cuenta/beneficios-disponibles)



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

Catálogo de beneficios vigentes del comercio, que el usuario puede comprar con
sus puntos.

Para saber cuáles le alcanzan, comparar el `cost` de cada beneficio con los
`points` de [`GET /v1/me`](https://docs.loybox.com.ar/api-reference/mi-cuenta/obtener). La API no filtra
por saldo: devuelve el catálogo y la UI decide qué mostrar como alcanzable y qué
como "te faltan N 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 [Beneficio](https://docs.loybox.com.ar/api-reference/objetos#beneficio).

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

```json
// 200 OK
[
  {
    "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": {
      "type": "percentage_discount",
      "title": "20% off",
      "description": "Válido en toda la tienda",
      "value": 20,
      "product": null,
      "expiration": "2026-12-31T23:59:59Z",
      "image": null
    },
    "tiendanube_coupon": null
  }
]
```

El `id` de cada item es lo que se manda como `benefit_id` a
[comprar un beneficio](https://docs.loybox.com.ar/api-reference/mi-cuenta/comprar-beneficio).

<Callout type="info" title="Sin login, el mismo catálogo es público">
  Para mostrarle el catálogo a un visitante que todavía no inició sesión hay
  [`GET /v1/public/benefits`](https://docs.loybox.com.ar/api-reference/publico/beneficios), que no necesita
  token.
</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`.                                      |