---
title: "List VIP tiers"
method: GET
path: "/vip_tiers"
tags: ["VIP Tiers"]
---

# List VIP tiers

`GET /vip_tiers`

Retrieves a list of VIP tiers.

## Query parameters

- `include` 'perks' | 'entry_rewards' — A comma-separated list of nested objects to include in the response.

## Response `200`

- object
  - `vip_tiers` VipTier[]
    - `id` integer — Unique identifier for the VIP tier.
    - `name` string — The display name of the VIP tier.
    - `image_url` string — The image of the VIP tier.
    - `milestone` number, float — The threshold that a customer must reach to be eligible for the VIP tier. Represents either an amount of points or a dollar amount, depending on the loyalty program's configuration.
    - `perks` object[] — A set of nested objects representing the ongoing benefits a customer is entitled to when they are in the VIP tier.
      - `name` string — A description of the benefit.
    - `entry_rewards` Reward[] — A set of nested Reward objects representing the rewards that are issued to a customer when they enter the VIP tier.
      - `id` integer — Unique identifier for the reward.
      - `name` string — The name of the reward.
      - `description` string — A description of the reward.
      - `image_url` string — An image for the reward.
      - `created_at` string, date-time — The date and time when the reward was created.
      - `updated_at` string, date-time — The date and time when the reward was last updated.

---

[API](https://skmtc.dev/smile/apis/smile-io-rest-api.md) · [All operations](https://skmtc.dev/smile/apis/smile-io-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smile/smile-io-rest-api/revisions/081bc804c5df/schema)