Skip to main content
Retrieves all VIP tiers configured for your organisation, sorted by threshold_value in ascending order. Each tier includes its associated benefits. GET /public/tiers

Authorizations

Authorization string header required Bearer authentication header of the form Bearer <token>, where <token> is your REST API token.

Response

200 - application/json data object[] Hide child attributes data.id string<uuid> Unique UUID identifier for the VIP tier. Example: "7fb39c85-3a3f-4247-8333-2e05a9c8ae28" data.name string The display name of the VIP tier. Example: "Gold" data.threshold_value integer The points value a customer must accumulate to reach this tier. Example: 1000 data.multiplier number The points earning multiplier applied to customers in this tier. Example: 2.0 data.icon_url string | null URL of the tier icon image. Example: "https://cdn.yukoapp.com/tiers/gold-icon.png" data.benefits object[] A list of benefits associated with this tier. Hide child attributes data.benefits.name string The display name of the benefit. Example: "10% Discount on every order" data.benefits.benefit_type string The type of benefit issued to the customer. Available options: fixed_discount, percentage_discount, free_shipping, multiplier Example: "percentage_discount" data.benefits.benefit_value object The value configuration for this benefit. Structure varies by benefit_type. Example: { "value": 10 } data.created_at string<date-time> Example: "2025-09-12T15:44:44.000Z"