# Benefits I can buy (https://docs.loybox.com.ar/en/api-reference/mi-cuenta/beneficios-disponibles)



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

The commerce's catalog of live benefits, which the user can buy with their points.

To know which ones they can afford, compare each benefit's `cost` with the
`points` from [`GET /v1/me`](https://docs.loybox.com.ar/api-reference/mi-cuenta/obtener). The API does not
filter by balance: it returns the catalog and the UI decides what to show as
reachable and what as "you need N more points".

## Headers
<Fields>
  <Field name="X-Commerce-Id" type="integer" location="header" required="true">
    Id of the commerce integrating the API. Every response is scoped to this
    commerce.
  </Field>
</Fields>

## Response
An array of [Benefit](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
  }
]
```

Each item's `id` is what you send as `benefit_id` to
[buy a benefit](https://docs.loybox.com.ar/api-reference/mi-cuenta/comprar-beneficio).

<Callout type="info" title="Without a session, the same catalog is public">
  To show the catalog to a visitor who has not signed in yet there is
  [`GET /v1/public/benefits`](https://docs.loybox.com.ar/api-reference/publico/beneficios), which needs no
  token.
</Callout>

## Errors
| Code  | When                                                                     |
| ----- | ------------------------------------------------------------------------ |
| `401` | The access token is missing, expired, or does not belong to an end user. |
| `422` | The `X-Commerce-Id` header is missing.                                   |