# Listar beneficios (https://docs.loybox.com.ar/api-reference/beneficios/listar)



<Endpoint method="GET" path="/v1/benefits/list" auth="api-key" />

Trae una lista de todos los beneficios creados por el comercio. Es el catálogo
completo, sin filtrar por vigencia ni por cliente.

No lleva parámetros ni paginación.

## 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/benefits/list \
  -H "Authorization: Bearer $LOYBOX_API_KEY"
```

```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": null,
    "tiendanube_coupon": null
  },
  {
    "id": "b_4c81",
    "type": "free_product",
    "description": "Café de regalo",
    "cost": 100,
    "expiration": null,
    "benefit_type": "welcome",
    "color": "#f1a10d",
    "buy_limit": 1,
    "prize": null,
    "tiendanube_coupon": null
  }
]
```

<Callout type="info" title="Trae también las recompensas especiales">
  El campo `benefit_type` distingue los beneficios del catálogo (`normal`) de las
  recompensas que el comercio entrega solas: `welcome`, `birthday`, `monthly_top` y
  `level`. Si querés mostrar sólo lo que el cliente puede comprar con puntos,
  filtrá por `normal`, o usá
  [beneficios que puede comprar](https://docs.loybox.com.ar/api-reference/clientes/beneficios-disponibles),
  que ya viene filtrado.
</Callout>

## Errores [#errores]

Este endpoint no declara errores propios más allá de los
[generales](https://docs.loybox.com.ar/api-reference/errores).