---
title: "Get Customer Tier Progress"
method: GET
path: "/api/v4.0/integrations/customers/{customerId}/tier-progress"
---

# Get Customer Tier Progress

`GET /api/v4.0/integrations/customers/{customerId}/tier-progress`

This API provides an overview of a customer's current tier and progression within Gameball's loyalty program. By retrieving the customer's current tier, progress level, and next tier details, this endpoint offers a clear view of their advancement within the tier structure.

## Path parameters

- `customerId` string, required

## Query parameters

- `expand` string

## Headers

- `lang` string

## Response `200`

Customer tier progress retrieved successfully

- CustomerTierProgressResponse
  - `current` TierState
    - `order` number — This represents the numerical order of a tier. Higher numbers indicate higher tiers.
    - `name` string — The name of the tier.
    - `minProgress` number — The minimum amount of progress a customer needs to reach the next 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 advance to the next tier.
    - `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. This offers a visual representation of the customer's tier status.
  - `next` TierState
    - `order` number — This represents the numerical order of a tier. Higher numbers indicate higher tiers.
    - `name` string — The name of the tier.
    - `minProgress` number — The minimum amount of progress a customer needs to reach the next 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 advance to the next tier.
    - `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. This offers a visual representation of the customer's tier status.
  - `progress` number — The current progress of the customer toward the next tier, reflecting their activity and engagement within the program. This value is calculated based on the client's chosen tiering-up method, indicating how close the customer is to advancing to a higher tier. 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. Possible Values: Total amount spent, Total points earned, Friends referred, Orders completed, Score.

---

[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)