# Catálogo de beneficios (https://docs.loybox.com.ar/api-reference/publico/beneficios)



<Endpoint method="GET" path="/v1/public/benefits" auth="none" />

Beneficios vigentes del comercio, **sin necesidad de token**.

Sirve para mostrarle el programa de fidelidad a un visitante que todavía no
inició sesión: es la vidriera de premios que responde "¿qué gano si me sumo?".

## 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/public/benefits \
  -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
  }
]
```

<Callout type="info" title="Con sesión, usá el de Mi cuenta">
  Una vez logueado conviene usar
  [`GET /v1/me/benefits/available`](https://docs.loybox.com.ar/api-reference/mi-cuenta/beneficios-disponibles),
  que es el mismo catálogo pero ya filtrado por lo que el comercio habilitó para
  ese usuario.
</Callout>

## Errores [#errores]

| Código | Cuándo                                              |
| ------ | --------------------------------------------------- |
| `400`  | No se pudieron obtener los beneficios del comercio. |
| `422`  | Falta el header `X-Commerce-Id`.                    |