---
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.

## Changes

- **2026-03-30** `a38b379b77d4` — 1 info
  - added the new optional `header` request parameter `lang`
- **2026-01-04** `d41638533261` — 1 info
  - api operation id `getCustomerTierProgress` was added
- **2025-12-17** `262228c13429` — 3 info
  - the endpoint scheme security `apiKey AND secretKey` was added to the API
  - the endpoint scheme security `apiKey` was removed from the API
  - the endpoint scheme security `secretKey` was removed from the API
- **2025-11-02** `f4bae7aa83d4` — 4 warning, 3 info
  - removed the optional property `customerId` from the response with the `200` status
  - removed the optional property `pointsBalance` from the response with the `200` status
  - removed the optional property `referrals` from the response with the `200` status
  - removed the optional property `tier` from the response with the `200` status
  - …3 more
- **2025-09-10** `2bc98dcabf95` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/gameballers/apis/gameball-api/changes/api/v4.0/integrations/customers/:customerId/tier-progress/get.md)

---

[API](https://skmtc.dev/gameballers/apis/gameball-api.md) · [All operations](https://skmtc.dev/gameballers/apis/gameball-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gameballers/gameball-api/revisions/747ba4697269/schema)