My benefits

The benefits the user already bought and can still redeem, with their code.

GET/v1/me/benefitsEnd-user token

Benefits the user already bought with their points at this commerce and can still redeem.

Each item's client_benefit_code is the code the user presents at the commerce to redeem it.

Headers

X-Commerce-Idintegerheaderrequired

Id of the commerce integrating the API. Every response is scoped to this commerce.

Response

An array of Redeemable benefit.

curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/me/benefits \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "X-Commerce-Id: 87"
// 200 OK
[
  {
    "client_benefit_code": 887766,
    "issue_date": "2026-08-24T13:05:00Z",
    "due_date": "2026-09-23T13:05: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
    }
  }
]

The code is the coupon

In an online store, the client_benefit_code is what the user pastes at checkout. It is worth showing it large and with a copy button, and the due_date next to it so they know how long they have to use it.

Errors

CodeWhen
401The access token is missing, expired, or does not belong to an end user.
422The X-Commerce-Id header is missing.