Tiers
Grant Tier Status
Tiers
Grant Tier Status
Grant Tier Status
PATCH
/tier_statuses/:id
Bearer*
curl --request PATCH \
--url https://api.thanx.com/tier_statuses/:id \
--header 'Authorization: Bearer <token>'This endpoint is only available in SANDBOX
Parameters
level
enum
The desired tier (bronze, silver, gold)
idrequired
string
The tier status id
Response
id
string
The ID of the tier status record
user_id
string
The user ID
merchant_id
string
The merchant ID
level
enum
Current tier state (bronze, silver, gold)
action_text
string
Description of what the user needs to do in order to earn the next tier
progress
decimal
Amount spent so far
expires_at
string
Current tier status expiration in ISO8601-format
current_tier_name
string
Name of current tier
next_tier_name
string
Name of next tier. This will be blank if the user has gold status
{
"tier_statuses": [
{
"id": "weourif",
"user_id": "woeru",
"merchant_id": "werouwer",
"level": "bronze",
"action_text": "Spend $100 before the end of the year to earn Silver.",
"progress": 50,
"expires_at": "2021-01-01T20:00:00Z",
"current_tier_name": "Bronze",
"next_tier_name": "Silver"
}
]
}
curl https://api.thanxsandbox.com/tier_statuses/:id \
-X PATCH \
$STANDARD_HEADERS
-d '{
"tier_status": {
"level": "silver"
}
}'
{
"tier_status": {
"id": "weourif",
"user_id": "woeru",
"merchant_id": "werouwer",
"level": "bronze",
"action_text": "Spend $100 before the end of the year to earn Silver.",
"progress": 50,
"expires_at": "2021-01-01T20:00:00Z",
"current_tier_name": "Bronze",
"next_tier_name": "Silver"
}
}
curl https://api.thanxsandbox.com/tier_statuses/:id \
-X PATCH \
$STANDARD_HEADERS
-d '{
"tier_status": {
"level": "silver"
}
}'
{
"tier_statuses": [
{
"id": "weourif",
"user_id": "woeru",
"merchant_id": "werouwer",
"level": "bronze",
"action_text": "Spend $100 before the end of the year to earn Silver.",
"progress": 50,
"expires_at": "2021-01-01T20:00:00Z",
"current_tier_name": "Bronze",
"next_tier_name": "Silver"
}
]
}