get_verified_stay_offer
Fetch a verified stay offer from the host's domain, signed for exact dates and guest count. Validates Ed25519 signature and returns the direct booking URL, without locking or creating a booking.
Instructions
Fetch, verify, and render a live host-domain signed VRP stay offer for exact dates and guest count. Verifies Ed25519 JWS against domain JWKS. Call after search returns a host domain, always before quoting final price or a booking link. Read-only: must not lock a quote, create a booking, collect guest details, or start checkout. Route booking only to the signed direct_booking_url on the host domain. The parameters work as a set: pass the same domain, checkIn, checkOut and guests the guest used at search; checkIn must be strictly before checkOut, and the resulting night count — not the dates themselves — drives the signed price and the host capacity check, so changing either date re-prices the offer. Omit language to inherit the host default; it never affects price or availability.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | Host-owned domain without protocol or path (e.g. 'villaakerlyckan.se', 'myvilla.it'). Optional; omit when the host has not chosen a domain yet. Invalid: 'https://...', paths, ports, or booking URLs. | |
| guests | Yes | Total guest count as positive integer (e.g. 2, 4). Used by the host node for capacity validation and guest-tier pricing on the signed offer. | |
| checkIn | Yes | Requested arrival date in YYYY-MM-DD format (e.g. '2026-11-14'). Must be strictly before checkOut. Use the same dates the guest requested in search. | |
| checkOut | Yes | Requested departure date in YYYY-MM-DD format (e.g. '2026-11-17'). Must be strictly after checkIn. Guest does not stay the departure night. | |
| language | No | Optional BCP-47 language tag for labels and formatting (e.g. 'en', 'sv', 'de', 'sv-SE'). Omit to use host default; does not change price or availability. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| fresh | No | True when the signed offer is still within its validity/freshness window. | |
| domain | Yes | Echoed host domain that issued the signed offer. | |
| guests | No | Echoed requested guest count. | |
| checkIn | No | Echoed requested arrival date. | |
| checkOut | No | Echoed requested departure date. | |
| verified | Yes | True only when the host-domain offer signature and payload checks pass. | |
| signature | No | Ed25519/JWS verification details, including key id and verification status. | |
| widget_media | No | Images and media hydrated from the verified host discovery document for the ChatGPT widget. | |
| agent_citation | No | Citation permission and safe-to-quote status derived from the signed offer. | |
| agent_guardrails | No | Rules the agent must follow when presenting or acting on this offer. | |
| payload_matches_offer | No | True when the signed payload matches the structured offer returned to the agent. | |
| official_offer_summary | No | Small signed-offer summary for agents to quote without inventing price, availability, discounts, savings, comparisons, or booking details. |