---
title: "Tiers Configurations"
method: GET
path: "/api/v4.0/integrations/configurations/tiers"
---

# Tiers Configurations

`GET /api/v4.0/integrations/configurations/tiers`

This API call retrieves the tiers configuration, including the benefits and rewards associated with each tier.

## Headers

- `lang` string

## Response `200`

VIP tiers retrieved successfully

- TierConfiguration[]
  - `name` string — The name of the tier.
  - `minProgress` number — The minimum amount of progress a customer needs to reach this tier in the program. This represents the threshold that must be met for a customer to reach this tier. Example: if the minProgress is set to 2000, the customer must accumulate 2000 points, referrals, or completed orders (depending on the tiering method) to reach this tier. Possible Values: Total amount spent, Total points earned, Friends referred, Orders completed, Score. Example: If the progress value is 1500 and the tiering-up method is total points earned, this means the customer has earned a total of 1500 points toward their next tier.
  - `order` number — This represents the numerical order of a tier. Higher numbers indicate higher tiers.
  - `icon` string — The URL for the icon associated with the tier. You can utilize this icon URL to display tier badges or indicators in your own custom interface, such as on customer profiles.
  - `benefits` object[] — It contains a list of rewards associated with the tier, each offering specific advantages to the customer. This array includes various types of benefits.
    - `type` string — Indicates the type of benefit the customer will receive. The possible values are: Custom Benefits (Offers tailored and custom rewards to offer customization for specific customer preferences or behaviors), Lifetime Reward (A benefit that can be used once at any time during the customer's lifetime with Gameball, as long as they remain in this tier), Loyalty Points Earning Custom Configuration (Enables customized settings for how customers earn loyalty points based on their spending amount), Entry Reward (A one-time reward granted to customers upon joining this tier).
    - `description` string, nullable — Description of the custom benefit.
    - `hyperLink` string, nullable — Hyperlink associated with the custom benefit.
    - `rankReward` number — The score rewarded for the customer as a reward.
    - `walletReward` number — The number of points the customer will earn for this reward.
    - `walletRewardFactor` number, nullable — This is a multiplier factor that indicates how the customer on their tier will be rewarded for each unit of currency they spend. This is returned for the benefits of type Loyalty Points Earning Custom Configuration. Example: If a tier has a walletRewardFactor of 2, it means any customer on this tier will earn 2 loyalty points for every $1 they spend. Therefore, if the customer spends $100, they would receive 200 loyalty points as a reward.
    - `couponReward` object, nullable — A coupon object that is awarded to the customer.
      - `couponType` string, nullable — The type of coupon applied. Possible values include: free_shipping, percentage_discount, fixed_discount, fixed_rate_discount, free_product, custom.
      - `discountValue` number, nullable — The value of the discount provided by the coupon in case the coupon type is fixed_discount, percentage_discount or fixed_rate_discount.
      - `product` object, nullable
        - `productId` string, nullable — The unique identifier for the product.
        - `productName` string, nullable — The name of the product.
        - `variantId` string, nullable — The unique identifier for the product variant.
        - `variantName` string, nullable — The name of the product variant.
        - `productDisplayName` string, nullable — The display name associated with the product that configured on the dashboard based on required language.
      - `collections` object[], nullable — A list of collection IDs that the coupon can be applied to.
        - `collectionId` string, nullable — The unique identifier for the collection.
        - `collectionName` string, nullable — The name for the collection.
      - `group` object, nullable
        - `handle` string, nullable — A unique identifier used to reference the coupon group in the system.
        - `title` string, nullable — The title of the coupon group.
        - `url` string, nullable — The URL for the coupon group.
        - `iconPath` string, nullable — The path to the icon of the coupon group.
        - `description` string, nullable — A description of the coupon group.
        - `maxPerCustomer` number, nullable — The maximum number of times a customer can use the coupon. Example: 5 indicates that each customer can redeem this coupon up to 5 times.
        - `startDate` string, date-time, nullable — The date when the coupons within this coupon group will become active and valid for redemption.
        - `expiryDate` string, date-time, nullable — The date when the coupons within this coupon group will expire and no longer be valid for redemption.
        - `isAvailable` boolean, nullable — Indicates whether the coupon group is currently available.
        - `isActive` boolean, nullable — Indicates whether the coupon group is currently active.
      - `options` object, nullable
        - `name` string, nullable — The name of the reward rule configured on the dashboard based on required language.
        - `expiryAfter` number, nullable — The number of days after creation that the coupon will expire. Example: If a coupon expires after 14 days, the customer must use it within that period to receive the discount.
        - `usageLimit` number, nullable — The maximum number of times a single coupon can be used. Example: If a coupon has a usage limit of 5, it can be redeemed up to 5 times before it becomes invalid.
        - `capping` number, nullable — The maximum discount value a coupon can provide, regardless of the order amount. Example: If a coupon offers 20% off with a capping of $50, the discount will not exceed $50, even if 20% of the order total is higher.
        - `minOrderValue` number, nullable — The minimum order amount required to apply the coupon. Example: If a coupon has a minimum order value of $100, the customer must spend at least $100 to use the discount.
        - `codePrefix` string, nullable — The prefix that will be added to the beginning of the generated coupon code. Example: If the prefix is "SUMMER", the generated coupon codes might look like "SUMMER12345" or "SUMMERDISCOUNT".
        - `redeemInstructions` string, nullable — The instructions on how the customer can redeem the coupon. Example: "Enter the coupon code at checkout to apply the discount."

---

[API](https://skmtc.net/gameballers/apis/gameball-api.md) · [All operations](https://skmtc.net/gameballers/apis/gameball-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gameballers/gameball-api/versions/2e4a8bfe2291/schema)