Purchased benefits
The benefits a client already bought and can still redeem, each with its redemption code.
Returns the benefits the client already bought with their points and can still redeem at the commerce.
It is the flip side of benefits they can buy: that one returns what their points cover, this one what is already theirs.
This is where the redemption code comes from
Each item's client_benefit_code is the code used to
look the benefit up and to
redeem it. It is the number the member
presents in the store or pastes at checkout.
Parameters
client_codestringpathrequiredThe client's code.
usedboolean | nullqueryLeft unspecified it returns only the redeemable ones: unused and unexpired.
true returns the already-redeemed ones and false the unredeemed ones, in
both cases without filtering by expiration.
The default behavior is the one you need to operate: showing the member what they
can use today. The used parameter is for querying the history.
Response
An array of Redeemable benefit.
curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/clients/12345/benefits \
-H "Authorization: Bearer $LOYBOX_API_KEY"// 200 OK
[
{
"client_benefit_code": 887766,
"issue_date": "2026-03-01T14:22:00Z",
"due_date": "2026-04-01T14:22:00Z",
"used": false,
"benefit": {
"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
}
}
]Errors
| Code | When |
|---|---|
401 | The API key is invalid: it has no commerce attached. |
404 | The client does not exist. |
422 | The code is not a valid format, or used is not a boolean. |