List benefits
Every benefit the commerce created.
GET/v1/benefits/listCommerce 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.
curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/benefits/list \
-H "Authorization: Bearer $LOYBOX_API_KEY"// 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
}
]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, which
comes pre-filtered.
Errors
This endpoint declares no errors of its own beyond the general ones.