My tier
The user's current tier, their points multiplier and what is missing to reach the next one.
The user's current tier at this commerce, with their points multiplier, their accumulated progress and which tier comes next.
The endpoint and its fields say level; this documentation says "tier", which is
the product's term in English. It is the same thing.
Headers
X-Commerce-IdintegerheaderrequiredId of the commerce integrating the API. Every response is scoped to this commerce.
Response
A Tier object.
curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/me/level \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "X-Commerce-Id: 87"// 200 OK
{
"name": "Plata",
"rank": 2,
"points_multiplier": 1.25,
"icon_url": "https://cdn.loybox.com.ar/levels/plata.png",
"reached_at": "2026-05-11T10:00:00Z",
"expiration_date": "2027-05-11T10:00:00Z",
"is_expired": false,
"next_level": {
"name": "Oro",
"rank": 3,
"threshold_type": "points",
"threshold": 5000
},
"total_earned_points": 3120,
"total_spent_amount": 312000,
"total_consumptions_count": 48
}The tier names in the example (Plata, Oro) are the ones the commerce typed.
They are data, not interface: Loybox does not translate them.
How to build the progress bar
Progress is calculated against the lifetime accumulated figure, not against the
balance. Depending on the next tier's threshold_type:
threshold_type | Compare it with |
|---|---|
| By points | total_earned_points |
| By amount spent | total_spent_amount |
Redeeming never demotes anyone
The tier is measured over the full history of the relationship, so spending points lowers the balance but never the tier. See How members move up.
Errors
| Code | When |
|---|---|
401 | The access token is missing, expired, or does not belong to an end user. |
404 | The user has no tier assigned at this commerce yet, or the commerce does not use tiers. |
422 | The X-Commerce-Id header is missing. |
The 404 is the normal case for a new member
Do not treat it as a failure. When the user has no tier yet, or the commerce does not use tiers, the right move is to hide the tiers section in the UI, not to show an error.