Lantern
REST APILoyalty API

Get Tiers

Retrieves all active loyalty tiers for the shop, including spend thresholds, point multipliers, and benefits. Tiers are returned in ascending order by spend threshold (lowest to highest).

GET
/tiers/

Response Body

application/json

application/json

application/json

curl -X GET "https://yourstore.myshopify.com/a/lantern/tiers/"
{
  "tiers": [
    {
      "id": "1",
      "name": "gold-member",
      "displayName": "Gold Member",
      "spendThreshold": 1000,
      "pointMultiplier": 2,
      "benefits": [
        "Earn 2 points per $1 spent",
        "Free shipping on all orders"
      ],
      "color": "#FFD700",
      "iconUrl": "https://storage.gadget.dev/gold-icon.png"
    }
  ]
}
{
  "error": "Invalid app proxy request"
}
{
  "error": "Shop not found",
  "shop": "nonexistent-store.myshopify.com"
}