Read Guesty reservation quote, payment, and balance objects for financial sync
domain: open-api-docs.guesty.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗
Steps
Create a price quote via the quotes endpoint, supplying listing ID, check-in/check-out dates, and guest count; the response includes rates, promotions, and applicable fees.
Convert the quote to a reservation within 24 hours, since Guesty only guarantees the quoted price is honored for that window.
Read the resulting reservation object's financial fields — guest invoice total, payments received, total payout, and total collected/balance due — rather than assuming a single "total" field covers all of these concepts.
Pull the tax breakdown used to calculate collected tax directly from the reservation payload instead of recomputing it independently.
Subscribe to the payments webhook family to get notified of failed or updated guest payments tied to a reservation instead of polling for balance changes.
Known gotchas
A quote's price is only valid for 24 hours — reservations created from a stale quote may fail or reprice, so don't cache quotes indefinitely before booking.
The reservation object mixes several distinct money concepts (invoice total, amount collected, host payout, balance due); pick the correct field per use case rather than assuming they're interchangeable.
Follow Guesty's documented guidance for syncing reservation financials with external accounting/invoicing systems rather than inferring a mapping, since fee and tax structures don't map 1:1 onto a simple ledger.
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?