VIP tiers

Your program’s VIP tiers and their milestones.

List tiers

GET /tiers

[
  {
    "id": "3",
    "name": "Gold",
    "milestone": 500,
    "multiplier": 2,
    "iconUrl": "https://...",
    "benefits": "...",
    "rewards": [
      {
        "id": "44",
        "name": "$5 off",
        "price": 10,
        "exchangeType": "stamps",
        "iconUrl": "https://..."
      }
    ]
  }
]

Tier fields

Both the list and single-tier endpoints return objects with these fields.

Field	Type	Description
id	string	Unique identifier.
name	string	Display name.
milestone	integer	Stamps required to reach the tier.
multiplier	number	Stamp-earning multiplier for members.
iconUrl	string	Icon URL if set (omitted otherwise).
benefits	string	Description of the tier’s benefits.
rewards	array	Reward products granted by this tier. Each object has id, name, price, exchangeType, and iconUrl.

Get a tier

GET /tiers/{id}

Returns a single tier (see Tier fields), or 404 TIER_NOT_FOUND.