PATCH
/
tier_statuses
/
:id
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"
    }
  ]
}

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 \
  $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"
  }
}