# Get tier information for a loyalty member

This method retrieves tier details for a specific member. Enter the member's user ID as a key to fetch all tier details for that member.

Endpoint: GET /users/{{memberId}}/tiers
Version: 3.0.0
Security: 

## Path parameters:

  - `memberId` (any, required)
    Enter unique ID of the member.
    Example: "user@domain.com"

## Response 200 fields (application/json):

  - `siteId` (string)
    Displays Annex Cloud’s site ID for the loyalty program.
    Example: "29235480"

  - `currentTier` (string)
    Displays the loyalty member's current tier name. For example, Bronze, Silver, Gold. The name of the tier is defined by the client during configuration of the loyalty program.
    Example: "Silver"

  - `nextTier` (string)
    Displays the name of the next tier which is awarded to the member once the required milestones are achieved.
    Example: "Gold"

  - `previousTier` (string)
    Displays the previous tier that was assigned to the member.
    Example: "Bronze"

  - `pointsToNextTier` (string)
    Displays the number of points required to achieve the next tier. This depends on the point threshold required to reach the next tier and the number of points the member currently has in their account. Note - The type is dependent on the decimal points precision set at the super admin level.
    Example: 210

  - `purchaseRatio` (string)
    Displays the purchase ratio defined in the Tier, which will be applied to the member’s purchases. For example, if the purchase ratio is 2 and purchase amount is 500, 1000  points are awarded to the member after completing the purchase.
    Example: 2

  - `currentTierPurchaseRatio` (string)
    Displays the purchase ratio that is applied to the member for this tier while earning points for purchase.
    Example: 2

  - `tierLimitType` (string)
    Displays the action points expiration date set for the tier. If ‘Rolling’ is selected, the result appears in days, whereas ‘Calendar’ shows the result in weeks, months, or years.
    Example: "Rolling"

  - `tierLimitPeriod` (string)
    Displays the Tier limit period in days, weeks, months or year.
    Example: "Day"

  - `maximumLimitPoints` (integer)
    Displays the maximum points that the member can earn in their current tier.
    Example: 500

  - `completedLimitPoints` (integer)
    Displays the current number of points earned by the member, not exceeding the maximum limit.
    Example: 200

  - `pendingLimitPoints` (integer)
    Displays the remaining points the member can earn until they reach the maximum point limit.
    Example: 500

  - `tierLimitReachedFlag` (integer)
    Displays the tier limit reached flag. When the flag is ON, it returns 1. When the flag is OFF, it returns 0.

  - `tierLimitReachedStatus` (string)
    Displays whether the member has reached the maximum point limit or not.
    Example: "Yes"

  - `spendAmountToNextTier` (integer)
    Displays the amount the member must spend to achieve the next tier. This is only applicable to tiers where the metric is spend-based. If the tier metric is points-based or based on extended attributes, it will not show any additional values.
    Example: 200

  - `tierAchievedDate` (string)
    Displays the current tier achievement date in yyyy-MM-dd'T'HH:mm:ssZ format.
    Example: "2018-04-01T00:00:00-0700"

  - `tierExpirationDate` (string)
    Displays the tier expiration date in yyyy-MM-dd'T'HH:mm:ssZ format. When the tier expiration date is reached, the current tier is no longer valID. The loyalty points are deducted, and the tier sequence restarts from the base tier.
    Example: "2018-04-01T00:00:00-0700"

  - `currentTierRewards` (object)
    Displays the current tier rewards details.

  - `currentTierRewards.rewardId` (integer)
    Displays the specific reward ID associated with the current tier.
    Example: 1234

  - `currentTierRewards.rewardName` (string)
    Displays the name of the reward.
    Example: "reward First"

  - `currentTierRewards.tierEligible` (string)
    Displays whether the member qualifies for the reward based on tier benefits or not.
    Example: "YES"

  - `currentTierRewards.rewardLimit` (integer)
    Displays the limit for how many times a member can claim the reward. For example, If the maximum user claim count is set to five, the reward could be claimed only five times. If the maximum user claim count is set to zero, there is no restriction on claiming rewards based on availability.
    Example: 2

  - `currentTierRewards.limitPeriod` (string)
    Displays the length of time the reward claim limit is in place. For example, if the claim limit was set to 4 and the limit period is “lifetime”, the member can only claim this reward 4 times in their lifetime with the loyalty program.
    Example: "Lifetime"

  - `currentTierRewards.redeemCount` (integer)
    Displays the number of times the member has redeemed the reward.

  - `currentTierRewards.remainingCount` (integer)
    Displays the remaining reward redemption count which can be claimed by the member. For example, if the maximum limit to avail the reward is 5 and the member has already claimed the reward 3 times, then the remaining count would be 2.
    Example: 1

  - `pointsEarnedInTier` (integer)
    Displays the points earned by the members while they were in the current tier.
    Example: 100

  - `spendAmountInTier` (integer)
    Displays the amount spent by the member in the current tier.
    Example: 100

  - `blockedStatus` (string)
    Display the blocked status of the member. (If Show Blocked User Details functionality is enabled from the super admin.). If the member is blocked, then it shows YES otherwise it shows No.
    Example: "YES"

  - `blockedBy` (string)
    Displays the email address of who blocked the member. (If Show Blocked User Details functionality is enabled from the super admin.)
    Example: "user@domain.com"

  - `blockedDate` (string)
    Displays the date on which the member was blocked in yyyy-MM-dd'T'HH:mm:ssZ format. (If Show Blocked User Details functionality is enabled from the super admin.)
    Example: "2020-10-12T00:00:00+0000"

  - `multiBucketsData` (object)
    Displays an array of all multi bucket details with the following fields when the multi bucket is enabled.

  - `multiBucketsData.[bucketName]` (object)
    Displays an array of all multi bucket names.

  - `multiBucketsData.[bucketName].pointsToNextTier` (integer)
    Displays the number of points required in the bucket to achieve the next tier. This depends on the point threshold required to reach the next tier and the number of points the member currently has in their account.
    Example: 100

  - `multiBucketsData.[bucketName].tier[bucketName]` (object)
    Displays an array of all multi bucket names.


## Response 403 fields

## Response 404 fields

## Response 405 fields