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

# VIP tier object

> The VIP tier object represents a loyalty tier level.

VIP tiers define the levels of your loyalty program. Customers are automatically assigned to tiers based on their lifetime points.

## Attributes

| Field               | Type           | Description                                             |
| ------------------- | -------------- | ------------------------------------------------------- |
| `name`              | string         | Tier display name                                       |
| `description`       | string \| null | Optional description                                    |
| `points_required`   | integer        | Lifetime points required to reach this tier             |
| `points_multiplier` | number         | Points earning multiplier for members of this tier      |
| `badge_image_url`   | string \| null | URL to the tier badge image                             |
| `badge_color`       | string \| null | Hex color code for the tier badge                       |
| `rewards`           | array          | Tier-exclusive rewards automatically granted to members |
| `created_at`        | string         | ISO 8601 timestamp                                      |
| `updated_at`        | string         | ISO 8601 timestamp                                      |

### Embedded rewards

Each item in the `rewards` array contains:

| Field             | Type            | Description                              |
| ----------------- | --------------- | ---------------------------------------- |
| `id`              | string          | Reward ID                                |
| `name`            | string          | Reward name                              |
| `description`     | string \| null  | Optional description                     |
| `discount_type`   | string          | Discount type                            |
| `reward_type`     | string          | Always `tier` for tier-exclusive rewards |
| `points_cost`     | integer         | Points cost                              |
| `discount_amount` | number          | Discount value                           |
| `minimum_spend`   | number \| null  | Minimum order value                      |
| `is_active`       | boolean         | Whether the reward is active             |
| `max_redemptions` | integer \| null | Maximum redemptions                      |
| `expiry_days`     | integer \| null | Days until discount code expires         |
| `created_at`      | string          | ISO 8601 timestamp                       |
| `updated_at`      | string          | ISO 8601 timestamp                       |

## Example

```json theme={null}
{
  "type": "vip_tier",
  "id": "tier_gold",
  "attributes": {
    "name": "Gold",
    "description": "Premium tier",
    "points_required": 500,
    "points_multiplier": 1.5,
    "badge_image_url": null,
    "badge_color": "#FFD700",
    "rewards": [
      {
        "id": "reward_abc",
        "name": "£5 off your next order",
        "description": null,
        "discount_type": "fixed",
        "reward_type": "tier",
        "points_cost": 500,
        "discount_amount": 5.00,
        "minimum_spend": 20.00,
        "is_active": true,
        "max_redemptions": null,
        "expiry_days": 30,
        "created_at": "2024-01-01T00:00:00.000Z",
        "updated_at": "2024-01-01T00:00:00.000Z"
      }
    ],
    "created_at": "2024-01-01T00:00:00.000Z",
    "updated_at": "2024-01-01T00:00:00.000Z"
  }
}
```