For developers

LoyalTribe Public API

Explore the LoyalTribe Public API — endpoints, auth and a built-in request tester.

OpenAPI YAML ↗OpenAPI JSON ↗AI documentation ↗

LoyalTribe Public API

Build your own loyalty widget on top of LoyalTribe. The complete, machine-readable definition — every endpoint, schema, parameter and auth scheme — is the OpenAPI 3.1 document:

/openapi.yaml — OpenAPI 3.1 spec (YAML)
/openapi.json — same spec as JSON
/api/mcp — MCP server (Model Context Protocol, Streamable HTTP). Connect an MCP client to call the API as tools.
/llms.txt — index of docs for AI tools

Base URLs (path prefix /api/public/v1):

Production: https://api.loyaltriberewards.com/api/public/v1
Staging: https://api.staging.loyaltriberewards.com/api/public/v1

Authentication: X-API-Key publishable key (pk_) on program, authentication, and customer requests; Authorization: Bearer customer JWT on /customer/*; Authorization: Bearer secret key (sk_) alone on server-to-server endpoints (/customers, /orders, /coupons/validate, /coupons/consume).

Endpoint groups: Program (/program, /program/tiers, /program/rewards, /program/rules), Customer Authentication (/auth/customer-token), Customer (/customer/me, /customer/balance, /customer/dashboard, /customer/history, /customer/redemptions, /customer/redeem), Gamification (/customer/gamification/*), Server-to-Server.