Skip to main content
PATCH
/
tier_statuses
/
:id
curl https://api.thanxsandbox.com/tier_statuses/:id \
  -X PATCH \
  -H "Content-Type: application/json"  \
  -H "Accept-Version: v4.0" \
  -H "Accept: application/json" \
  -H "X-ClientId: ${client_id}" 
  -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"
    }
  ]
}
Please review proper request headers here.
This endpoint is only available in SANDBOX

​
Parameters

​
level
enum
The desired tier (bronze, silver, gold)
​
id
string
required
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 \
  -H "Content-Type: application/json"  \
  -H "Accept-Version: v4.0" \
  -H "Accept: application/json" \
  -H "X-ClientId: ${client_id}" 
  -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"
  }
}