Check a guest's redeemable loyalty points and redeem them against an invoice using Zenoti's Loyalty Points APIs
domain: docs.zenoti.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Call GET /v1/guests/{InvoiceId}/payments/loyalty_points/redeemable to see how many points and how much dollar value a guest can redeem toward a specific invoice, optionally scoped to a lp_program_id.
Call the loyalty points history endpoint (GET) to review points earned vs. redeemed over time for the guest.
Call the loyalty points (earned/redeemed) endpoint (GET) to get a guest's current point balance across loyalty programs.
To apply points as payment, call the 'Redeem the loyalty points of a guest' invoice endpoint (POST) with the invoice ID and the points/amount to redeem.
Close the invoice once payment, including redeemed points, covers the total.
Known gotchas
redeem_across_programs defaults to 0 (single program); set it to 1 to redeem across all of a guest's loyalty programs instead of prioritizing lp_program_id.
Error code 502 covers multiple distinct failure reasons (invalid invoice_id, invalid ProgramId) — inspect the message text, not just the numeric code.
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?