> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yuko.so/llms.txt
> Use this file to discover all available pages before exploring further.

# List VIP tiers

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"`

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url "https://api.yukoapp.com/api/v1/public/tiers" \
    --header "Authorization: Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.yukoapp.com/api/v1/public/tiers",
    {
      method: "GET",
      headers: {
        Authorization: "Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      },
    }
  );

  const data = await response.json();
  ```

  ```php PHP theme={null}
  $ch = curl_init();
  curl_setopt($ch, CURLOPT_URL, "https://api.yukoapp.com/api/v1/public/tiers");
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
  curl_setopt($ch, CURLOPT_HTTPHEADER, [
      "Authorization: Bearer py_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  ]);

  $response = curl_exec($ch);
  curl_close($ch);

  $data = json_decode($response, true);
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "7fb39c85-3a3f-4247-8333-2e05a9c8ae28",
        "name": "Silver",
        "threshold_value": 500,
        "multiplier": 1.5,
        "icon_url": null,
        "benefits": [
          {
            "name": "5% Discount on every order",
            "benefit_type": "percentage_discount",
            "benefit_value": { "value": 5 }
          }
        ],
        "created_at": "2025-09-12T15:44:44.000Z"
      },
      {
        "id": "8ac40d96-4b4e-5358-9444-3f16ba d9bf39",
        "name": "Gold",
        "threshold_value": 1000,
        "multiplier": 2.0,
        "icon_url": "https://cdn.yukoapp.com/tiers/gold-icon.png",
        "benefits": [
          {
            "name": "10% Discount on every order",
            "benefit_type": "percentage_discount",
            "benefit_value": { "value": 10 }
          },
          {
            "name": "Free Shipping",
            "benefit_type": "free_shipping",
            "benefit_value": {}
          }
        ],
        "created_at": "2025-09-12T15:44:44.000Z"
      }
    ]
  }
  ```

  ```json 401 theme={null}
  {
    "error": {
      "code": "invalid_token",
      "message": "Invalid or revoked API token"
    }
  }
  ```
</ResponseExample>