API Documentation

Read-only REST API. Available on the Pro plan.

Getting your API key

If you're on the Pro plan, go to Dashboard → Settings → API Access and click Generate API Key. Keep this key secret — anyone with it can read your business's loyalty data.

Authentication

Every request must include your api_key as a query parameter or form field. Requests without a valid key for a Pro-plan business return:

{
  "response": {
    "error": "invalid_or_unauthorized_api_key"
  }
}

Base URL

https://app.loyaltyloop.co/api/1.1/wf

Endpoints

GEThttps://app.loyaltyloop.co/api/1.1/wf/api_v1_summary

Aggregate stats for your business: card, customer, stamp, and reward counts, plus redemption rate.

Parameters

api_key (required) — Your API key.

Example response

{
  "response": {
    "cards_count": 42,
    "customers_count": 318,
    "stamps_count": 1204,
    "rewards_count": 87,
    "redemption_rate": 63
  }
}

GEThttps://app.loyaltyloop.co/api/1.1/wf/api_v1_cards

List all loyalty cards for your business.

Parameters

api_key (required) — Your API key.

Example response

{
  "response": {
    "cards": [
      { "_id": "...", "name": "Coffee Card", "stamps_required": 10 }
    ]
  }
}

GEThttps://app.loyaltyloop.co/api/1.1/wf/api_v1_customers

List all customers who have joined a loyalty card at your business.

Parameters

api_key (required) — Your API key.

Example response

{
  "response": {
    "customers": [
      { "_id": "...", "name": "Jane Doe", "phone": "+351..." }
    ]
  }
}

GEThttps://app.loyaltyloop.co/api/1.1/wf/api_v1_stamps

List stamps collected at your business, optionally filtered by date range.

Parameters

api_key (required) — Your API key.
start_date (optional) — ISO date. Omit to include all history.
end_date (optional) — ISO date. Omit to include up to now.

Example response

{
  "response": {
    "stamps": [
      { "_id": "...", "Created Date": "2026-07-01T12:00:00Z" }
    ]
  }
}

GEThttps://app.loyaltyloop.co/api/1.1/wf/api_v1_rewards

List rewards issued at your business, optionally filtered by status.

Parameters

api_key (required) — Your API key.
status (optional) — e.g. "redeemed". Omit to include all statuses.

Example response

{
  "response": {
    "rewards": [
      { "_id": "...", "status": "redeemed" }
    ]
  }
}

Questions

Email hello@loyaltyloop.co if you run into issues integrating with the API.