Read Profile Tier

A GET to the /profiles/{profileId}/tiers endpoint allows your application to retrieve a Profiles Tier data.

📘

Tier Definitions

The Profile tier contains information about the tier in relation to the profile.
Tier definitions contain data unique to each individual tier.
For further information about the structure of data unique to each tier, you can review Tier Definitions

JSON

{
   "id":663,
   "profile_id":"92441ab4-331a-41dc-b598-9fa22311b3",
   "current_tier":{
      "id":1,
      "name":"Bronze",
      "handle":"bronze",
      "is_floor":true,
      "value_min":0,
      "value_maintain":0,
      "is_assignable":false,
      "internal_notes":null,
      "description":null,
      "short_description":"Bronze",
      "long_description":"<p>Bronze Tier </p>",
      "terms_conditions":null,
      "icon":null,
      "image_url":null,
      "earn_instructions":null,
      "tags":[
         
      ],
      "created_at":"2020-05-15 11:18:24",
      "updated_at":"2020-11-19 11:18:24"
   },
   "next_tier":{
      "id":2,
      "name":"Silver",
      "handle":"silver",
      "is_floor":false,
      "value_min":1000,
      "value_maintain":1000,
      "is_assignable":true,
      "internal_notes":null,
      "description":null,
      "short_description":"★",
      "long_description":"<p>Silver Tier</p>",
      "terms_conditions":null,
      "icon":null,
      "image_url":null,
      "earn_instructions":null,
      "tags":[
         
      ],
      "created_at":"2020-05-15 11:19:04",
      "updated_at":"2020-11-19 11:17:47"
   },
   "prev_tier":null,
   "is_floor":true,
   "current_credit":0,
   "current_progress":0,
   "current_remain":0,
   "next_progress":0,
   "next_remain":1000,
   "total_points_12m":0,
   "total_points_achievement":null,
   "anniversary_at":"2022-01-21 23:59:59",
   "assigned_at":null,
   "achieved_at":"2021-01-21 00:00:00",
   "created_at":"2021-01-21 01:07:28",
   "updated_at":"2021-01-21 01:07:28"
}

Tier Properties

Header level tier data containing information about the profiles tier progress as a whole

id INTEGER READ-ONLY	The ID of the profile tier record
profile_id STRING	The profile_id of the profile the tier is attached to.
current_tier OBJECT TIER	The current tier the profile has achieved.
next_tier OBJECT TIER	The next level tier the profile can achieve
prev_tier OBJECT TIER	The previous tier the profile has achieved
is_floor BOOLEAN	Denotes whether this profile is currently on the lowest tier the profile can achieve
current_credit INTEGER	The total points issues this year, minus the value_min How much credit was applied when the member achieved this tier. For example, if their annual spend was $600 when the tier was achieved but the tier threshold is $500 they will have a $100 credit toward their maintenance goal for that year.
current_progress INTEGER	How much the member has spent since achieving their current tier. This marks their "progress" towards achieving the maintenance goal for the current year.
current_remain INTEGER	The remaining points required to achieve the maintenance goal for the current tier, for the current year
next_progress INTEGER	How much the member has spent in the last 365 days. This marks their "progress" towards achieving the next tier.
next_remain INTEGER	The remaining points required to achieve the next tier.
total_points_12m INTEGER	The total amount of point achieved in the last 12m
total_points_achievement INTEGER	The total points achieved issues after the achieved_at date (the date of the latests achieved tier)
anniversary_at DATE-TIME	the anniversary of the date the member achieved their latest tier
assigned_at DATE-TIME	The date the current tier was manually assigned to the member. If the member achieved this normally, this field will be null
achieved_at DATE-TIME	The date the member achieve their current profile tier
created_at DATE-TIME READ-ONLY	The UTC date & time the Profile record was created in ISO 8601 format.
updated_at DATE-TIME READ-ONLY	The UTC date & time the Profile record was last updated in ISO 8601 format.