Skip to main content
GET
/
v1
/
vip-tiers
List VIP tiers
curl --request GET \
  --url https://api.mageloyalty.com/v1/vip-tiers \
  --header 'Authorization: <api-key>'
List all VIP tiers for the shop, ordered by points_required ascending.
No pagination parameters — all tiers are returned in a single response. Most shops have 3-5 tiers.

​
Response

{
  "data": [
    {
      "type": "vip_tier",
      "id": "tier_bronze",
      "attributes": {
        "name": "Bronze",
        "description": "Entry level tier",
        "points_required": 0,
        "points_multiplier": 1.0,
        "badge_image_url": null,
        "badge_color": "#CD7F32",
        "rewards": [],
        "created_at": "2024-01-01T00:00:00.000Z",
        "updated_at": "2024-01-01T00:00:00.000Z"
      }
    },
    {
      "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"
      }
    }
  ]
}