Get available ways to earn loyalty points

Returns all active point earning campaigns and rules that the customer can participate in. This shows customers how they can earn more points.

Full behavior, validation rules, and side effects

Common Earning Methods:

• Points per dollar spent on purchases
• Bonus points for first subscription
• Points for referring friends
• Birthday bonus points
• Social media follows (Instagram, Facebook, Twitter)
• Product reviews
• Account creation bonus

Response includes:

• Campaign name and description
• Points awarded
• Action required (e.g., ‘Follow on Instagram’)
• Icon/image URL
• Terms and conditions

Use Cases:

• Display ‘Ways to Earn’ section in customer portal
• Show earning opportunities on product pages
• Encourage customer engagement

Authentication: Customer must be logged in via Shopify customer session

GET /subscriptions/cp/api/loyalty-integration/earn-options

Get available ways to earn loyalty points

cURL

curl --request GET \
  --url https://www.myshop.com/apps/subscriptions/cp/api/loyalty-integration/earn-options

200

[
  {
    "name": "Purchase Rewards",
    "description": "Earn 5 points for every $1 spent",
    "pointsAmount": 5,
    "action": "Make a purchase"
  },
  {
    "name": "Refer a Friend",
    "description": "Earn 500 points when your friend makes their first purchase",
    "pointsAmount": 500,
    "action": "Share referral link"
  }
]

Query Parameters

customerId · string

Customer ID (optional, auto-detected from session)

Response

200

application/json

Earning options retrieved successfully