hemmabo_booking_quote
Get a detailed pricing quote for a specific property, dates, and guest count after confirming availability. Returns per-night breakdown and final total in local currency.
Instructions
Get a detailed pricing quote for a specific property, dates, and guest count. Use this tool after confirming availability to show the user exact pricing before booking. Do NOT use before checking availability — the quote may be invalid if dates are unavailable. Returns the final host-source total for the booking flow, per-night breakdown, and package pricing context. All prices are integers in the property's local currency (e.g. SEK). The quote is the propertyId priced for the exact checkIn/checkOut range and guests; the night count and party size together select the price tier, so changing any of them re-quotes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guests | Yes | Total guest count as a positive integer (e.g. 2, 4, 6). Used for capacity filtering and staircase pricing tiers. Properties with maxGuests below this value are excluded from search results. | |
| checkIn | Yes | Arrival date in ISO 8601 calendar format YYYY-MM-DD (e.g. '2026-07-15'). Must be today or later in the property's timezone. Must be strictly before checkOut; together they define the stay length used for pricing and availability. | |
| checkOut | Yes | Departure date in ISO 8601 calendar format YYYY-MM-DD (e.g. '2026-07-22'). Must be strictly after checkIn on the same calendar. The guest does not stay the departure night. | |
| propertyId | Yes | Stable property UUID from hemmabo_search_properties (e.g. '550e8400-e29b-41d4-a716-446655440000'). Pass the exact UUID string — never a property name, host domain, or booking URL. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when isError=true. | |
| guests | No | ||
| nights | No | Number of nights in the range. | |
| checkIn | No | ||
| checkOut | No | ||
| currency | No | ISO 4217 currency code. | |
| gapNight | No | True when the stay qualifies as a gap fill. | |
| gapTotal | No | Gap-night adjusted total when applicable; otherwise null. | |
| breakdown | No | Detailed pricing breakdown. | |
| propertyId | No | ||
| publicTotal | No | Website rate total in minor currency units. | |
| packageApplied | No | Applied package, if any. | |
| federationTotal | No | Legacy field: direct host-source total. Prefer directBookingTotal in user-facing copy. | |
| directBookingTotal | No | Preferred user-facing field: direct host-source total. | |
| gapDiscountPercent | No | Gap-night discount percentage when applied. | |
| hostSourcePublicTotal | No | Preferred user-facing field: public host-source total. | |
| federationDiscountPercent | No | Legacy internal field. Do not present this as a guest-facing discount, savings, or comparison. | |
| directBookingDiscountPercent | No | Legacy internal field. Do not present this as a guest-facing discount, savings, or comparison. |