Skip to main content

Loyalty API

Required scope: loyalty:read

List Loyalty Tiers​

GET /api/v1/loyalty_tiers

Returns all active loyalty tiers ordered by level.

Response​

{
  "data": {
    "loyalty_tiers": [
      {
        "id": 1,
        "name": "Bronze",
        "level": 1,
        "color": "#CD7F32",
        "minimum_lifetime_spend": 0,
        "discount_percentage": 0,
        "points_multiplier": 1.0
      },
      {
        "id": 2,
        "name": "Gold",
        "level": 3,
        "color": "#FFD700",
        "minimum_lifetime_spend": 1000,
        "discount_percentage": 5,
        "points_multiplier": 1.5
      }
    ]
  }
}

List Loyalty Rewards​

GET /api/v1/loyalty_rewards

Returns available rewards that customers can redeem with points.

Query Parameters​

ParameterTypeDescription
customer_idintegerOnly show rewards this customer can currently redeem

Customer Loyalty Info​

Customer loyalty data (points, tier, visit count) is included in the Customers API response fields: loyalty_tier, loyalty_points, lifetime_spend, visit_count.