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



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

Returns a list of every benefit created by the commerce. It is the full catalog,
unfiltered by validity and unfiltered by member.

It takes no parameters and no pagination.

## 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/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="It also returns the automatic rewards">
  The `benefit_type` field separates catalog benefits (`normal`) from the rewards the
  commerce hands out on its own: `welcome`, `birthday`, `monthly_top` and `level`. If
  you want to show only what the member can buy with points, filter by `normal`, or
  use [benefits they can buy](https://docs.loybox.com.ar/api-reference/clientes/beneficios-disponibles), which
  comes pre-filtered.
</Callout>

## Errors
This endpoint declares no errors of its own beyond the
[general ones](https://docs.loybox.com.ar/api-reference/errores).