List Open Loyalty rewards and let a member redeem one by spending points

domain: help.openloyalty.io · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. GET /api/{storeCode}/reward to list the reward catalog, and GET /api/{storeCode}/member/{member} to check the member's current points balance.
  2. POST /api/{storeCode}/reward/{reward}/buy with the member's customerId and any reward-type-specific fields (quantity, couponValue, withoutPoints, dateValid), since the request shape varies by reward type (static coupon, dynamic coupon, conversion coupon, material reward).
  3. Handle documented error cases such as insufficient points or no coupons remaining in the reward's pool.
  4. On success, retrieve the issued coupon using the returned issuedRewardId, or list it via the reward's coupon endpoint.
  5. For campaign-driven free rewards, pass withoutPoints: true so points aren't deducted on redemption.

Known gotchas

Related routes

Add, spend, and audit Open Loyalty member points via the Points Transfer API
help.openloyalty.io · 5 steps · unrated
List active Yotpo Loyalty redemption options and redeem points for a reward, including delayed-deduction checkout flows
loyaltyapi.yotpo.com · 5 steps · unrated
Check a guest's redeemable loyalty points and redeem them against an invoice using Zenoti's Loyalty Points APIs
docs.zenoti.com · 5 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans