Loyalty Programs API

Lets a loyalty platform read the retail stores that take part in a SnowBee loyalty program — for example to show a member where their program is honoured.

This guide assumes you have read Get started.

What you need

A Client ID and Client Secret for an API client with access to the loyalty program
Your Tenant ID
The Loyalty Program ID — the resource in the token request

Request the token with scope: "loyalty_programs" and resource: "<Loyalty Program ID>". Endpoints live under:

https://api.snowbee.no/v1/tenants/TENANT_ID/loyalty_programs/LOYALTY_PROGRAM_ID/

Endpoints

Endpoint	Description
`GET /retail_stores`	Retail stores in the loyalty program. Only stores with status `RELEASED` are included.

Example

curl "https://api.snowbee.no/v1/tenants/TENANT_ID/loyalty_programs/LOYALTY_PROGRAM_ID/retail_stores" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "retailStores": [
    {
      "id": "019c1234-5678-7abc-8def-123456789012",
      "number": "1001",
      "name": "Bjørklund Storo",
      "email": "storo@example.com",
      "phone": "+4712345678",
      "webAddress": "https://example.com/storo",
      "addresses": [ { "...": "see the API Reference" } ]
    }
  ]
}

The list is complete (no pagination) and changes rarely; cache it and refresh a few times a day. A 404 means the loyalty program does not exist for this tenant.

Next steps

API Reference — field-level documentation, tag Loyalty Programs