A Reward resource represents something that customers may spend their points on.
|Unique ID of the reward in LoyaltyLion|
|The kind of reward|
|The display title of the reward, in your site’s primary language|
|Optional extra reward description|
|Additional content that’s needed when working with or rendering the reward. This may include things like image urls, fulfilment_instructions, or other strings you may want to render or utilize in some way|
|The cost of redeeming the reward in points|
|How the reward is redeemed; one of |
|The monetary effect of the discount. One of |
|When the reward has a specific monetary or percentage value, that value as a unit-less number. So if the discount amount is £5 or 5%, this returns |
|The amount a customer must spend to be able to use the reward. A |
|The number of times the reward may be used once claimed, typically 1|
|The minimum multiplier of the reward that can be claimed at once|
|The maximum multiplier of the reward that can be claimed at once|
|The maximum amount that can be deducted from shipping by a free shipping reward. If null then there is no limit|
|The site ID the reward is associated with|
|1-based position of the reward in the loyalty program’s list of rewards|
|A reward site describing where a reward may be used|
|What orders the reward applies to; one of |
|What the reward applies to; one of |
|An array of target collections|
|An array of target products|
|A reward session options object (see below)|
|A reward expiry options object (see below)|
A Site indicates the site (ecommerce store, POS location, blog) that this reward is usable on.
id field doesn’t match the parent
reward.site_id, that indicates that this is a cross-store reward.
|The ID of the target site|
|The name of the target site|
|The URL linking to the target site|
A Target Collection represents a product collection that this reward is applicable to.
|The ID of the target collection|
|The URL linking to the target collection|
|Text shown when the reward isn’t usable due to items not being in the correct collection|
A Target Product represents a product that this reward is applicable to.
|The ID of the target product|
|The variant ID of the target product|
|The SKU of the target product|
|The URL linking to the target product|
|The URL linking to the image of the target product|
|The key used to sort the target product|
|The title of the target product|
Reward session options
Session options, when present, describe any limits on how many of this reward may be claimed within a particular checkout session.
null, the reward has no claim limit per session (though it may still have an overall usage limit).
|The kind of session the reward links to, one of |
|The number of times the reward should be claimed in one session, typically 1. Please note, this limit is not enforced by LoyaltyLion. Enforcing this limit is the responsibility of the API consumer.|
Reward expiry options
Expiry options describe how the reward will expire. Rewards that do not expire are
denoted by kind
|The kind of expiry option for the reward, one of |
|The number of seconds, after being claimed, that the reward will expire|
Returns a list of the rewards currently available to this customer.
Rewards are available to a customer for the purposes of this API if:
- The reward is enabled
- If a customer is in a loyalty tier, the reward is available on that tier
- The reward is supported based on your platform
For seamless product rewards, these additional conditions apply:
- Instant points are not enabled
- Shopify scripts are in use
|Shopify||one-off voucher rewards, custom rewards, checkout rewards, free product vouchers, seamless free products|
|Adobe Commerce (formerly Magento)||one-off voucher rewards, custom rewards, free product vouchers|
|BigCommerce||one-off voucher rewards, custom rewards, free product vouchers|
Available rewards include those that cost more points than the customer currently has available.
:merchant_id provided should match your own internal ID for the customer in your database.
This request takes no parameters.
The endpoint returns a list of rewards.
curl -X GET \ --url 'https://api.loyaltylion.com/v2/customers/1001/available_rewards' \ --header 'Content-Type: application/json'