Get customer loyalty points and rewards data

Retrieves the loyalty/rewards program data for the currently logged-in customer. This includes points balance, tier status, and available rewards.

Full behavior, validation rules, and side effects

Supported Loyalty Programs:

• Appstle Loyalty & Rewards
• Yotpo Loyalty & Referrals
• Smile.io (via Appstle integration)

What you get:

• Current points balance
• Points pending (from recent orders)
• VIP tier/level
• Points history
• Available reward redemptions

Use Cases:

• Display points balance in customer portal
• Show available rewards customer can redeem
• Display VIP tier badge
• Show points expiration dates

Authentication: Customer must be logged in via Shopify customer session

Note: Requires loyalty app integration to be configured in merchant settings

GET /subscriptions/cp/api/loyalty-integration/customer

Get customer loyalty points and rewards data

cURL

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

200

{
  "pointsBalance": 1250,
  "pointsPending": 150,
  "tierName": "Gold",
  "pointsToNextTier": 250,
  "customerEmail": "[e-mail]"
}

Response

200

application/json

Loyalty data retrieved successfully