Listar beneficios
Todos los beneficios que creó el comercio.
GET/v1/benefits/listAPI key del comercio
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
Un array de Beneficio.
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
}
]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,
que ya viene filtrado.
Errores
Este endpoint no declara errores propios más allá de los generales.