GET
/
headless
/
2025-06
/
{site_id}
/
configuration
curl --request GET \
  --url https://api.loyaltylion.com/headless/2025-06/{site_id}/configuration \
  --header 'Authorization: Bearer <token>'
{
  "channel": "web",
  "currency": "usd",
  "language": "en",
  "program": {
    "name": "Lion Rewards"
  },
  "tier_configuration": {
    "boundary_mode": "spend",
    "tiers": [
      {
        "id": 1,
        "name": "Silver",
        "benefit_ids": [
          1
        ],
        "hidden": false,
        "kind": "spend",
        "position": 1,
        "lower_bound": {
          "amount": 0,
          "formatted": "$0"
        },
        "upper_bound": {
          "amount": 99.99,
          "formatted": "$99.99"
        }
      },
      {
        "id": 2,
        "name": "Gold",
        "benefit_ids": [
          1,
          2
        ],
        "hidden": false,
        "kind": "spend",
        "position": 2,
        "lower_bound": {
          "amount": 100,
          "formatted": "$100"
        },
        "upper_bound": null
      }
    ],
    "tier_benefits": [
      {
        "id": 1,
        "label": "Early access to new products",
        "secret": false,
        "details": null
      },
      {
        "id": 2,
        "label": "Free makeup classes",
        "secret": false,
        "details": {
          "plaintext": "Email classes@example.com to sign up to a class\n",
          "html": "<p>Email classes@example.com to sign up to a class</p>"
        }
      }
    ],
    "membership": {
      "mode": "rolling",
      "duration_months": 12
    }
  },
  "referee_incentive": {
    "minimum_spend": {
      "amount": 9.9,
      "formatted": "$9.90"
    },
    "incentive_text": "Get a 10% discount on your order with this code when you spend over $50",
    "kind": "cart_discount_voucher",
    "discount_kind": "percentage",
    "discount": {
      "percentage": 10,
      "formatted": "10%"
    }
  },
  "rules": [
    {
      "id": 123,
      "limit": {
        "count": 123,
        "interval": "day"
      },
      "kind": "birthday",
      "variants": [
        {
          "tier_id": 123,
          "title": "Make a purchase",
          "enabled": true,
          "result": {
            "kind": "points",
            "per_currency_unit": 1,
            "points": 5
          },
          "result_short_text": "5 points per $1"
        }
      ]
    }
  ],
  "rewards": [
    {
      "id": 123,
      "limit": {
        "count": 123,
        "interval": "day"
      },
      "kind": "gift_card",
      "properties": {
        "initial_balance": {
          "amount": 9.9,
          "formatted": "$9.90"
        }
      },
      "variants": [
        {
          "tier_id": 123,
          "title": "$5 voucher",
          "enabled": true,
          "cost": {
            "kind": "fixed",
            "points": 123
          },
          "cost_text": "100 points"
        }
      ]
    }
  ]
}

Use this endpoint to retrieve the full configuration for a site, based on the requested sales channel.

This configuration includes tier details, rules, rewards and various other settings that can be used to construct a custom shopper-facing frontend.

This endpoint has a rate limit of 100 requests per second

If you anticipate making a high volume of calls to this endpoint, e.g. if you are calling it on each page render, consider caching the returned configuration for a short period (max 30 seconds) and reusing it

Authorizations

​
Authorization
string
header
required

An API key linked to a Program in LoyaltyLion, with a set of permissions (scopes). API keys can be created manually, or acquired through an OAuth2 flow. The API key should be provided as a Bearer token in the Authorization header

Path Parameters

​
site_id
number
required

Your LoyaltyLion Site ID

Query Parameters

​
channel
enum<string>

The sales channel from which this request is made. Must be provided as this query parameter, or the X-LoyaltyLion-Channel header

Available options:
web,
pos,
mobile

Response

200
application/json

200

The response is of type object.