Introduction

The LoyaltyLion Headless API can be used to build headless integrations. For example, it can be used to:

• build a custom UI for a headless ecommerce storefront, e.g. Shopify Hydrogen
• incorporate your loyalty program into a mobile app, using native UI components, or a custom POS system

You can use Headless API endpoints to:

• retrieve program configuration, including rules, rewards, and tiers
• find, create, and enroll customers
• redeem rewards and trigger rules for customers

​

Authentication

Headless API endpoints support API keys and OAuth for authentication. The legacy token & secret authentication method is not supported.

​

Required request parameters

Headless API endpoints require a site_id property in the path, and a channel property passed as a query parameter or header.

​

Site ID

All Headless API endpoints require a site_id in the path, e.g. GET /headless/2025-06/{site_id}/configuration.

This is the ID of your site in LoyaltyLion. You can find it by signing into LoyaltyLion - it’s the number after the /sites/ part of the URL, e.g. /sites/123.

If you have a multi-site program, you can use any of the site IDs within the program to interact with the Headless API.

​

Channel

Program configuration can vary based on the current channel, which will be one of pos (point of sale), web (online storefront), and mobile (mobile app). For example, rewards can be configured to only work on POS, in which case those rewards won’t be included in the responses for any API calls where channel=web.

The value of this parameter should match the platform in which you’re using the Headless API. For example, if you’re using the API inside a native mobile app, you should set the channel to mobile.

To pass this parameter as a HTTP header, use X-LoyaltyLion-Channel.