hemmabo_booking_status
Retrieve current status and full details of an existing booking by providing its reservationId and guestToken. Use this to confirm checkout/create success or before canceling/rescheduling, but do not use for property discovery or pricing.
Instructions
Retrieve current status and full details of an existing booking by reservationId. Use to confirm checkout/create succeeded or before cancel/reschedule. Do NOT use for property discovery, availability, or pricing — use hemmabo_search_properties, hemmabo_search_availability, or hemmabo_booking_quote for those. Requires Authorization: Bearer token (MCP_API_KEY or OAuth); rate-limited per token. Read-only against the database — never writes, so it is safe to poll after a checkout timeout — but returns guest PII (name, email). reservationId is the booking UUID returned by hemmabo_booking_checkout or hemmabo_booking_create — never a propertyId — and guestToken is the secret issued with that same booking: a mismatched pair reveals nothing, not even that the booking exists. Without a reservationId there is no booking to look up yet.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guestToken | Yes | Per-booking secret returned by hemmabo_booking_create / hemmabo_booking_checkout (the booking's guest_token, a UUID). Required to view or modify this specific booking — a valid Bearer token alone is NOT sufficient, because it authenticates the caller but grants no authority over any particular booking. Present the exact guestToken you received when the booking was created; without the matching value the call is refused. Never a propertyId or reservationId. | |
| reservationId | Yes | Booking or reservation UUID from hemmabo_booking_checkout or hemmabo_booking_create (e.g. '7c9e6679-7425-40de-944b-e07fc1f90ae7'). Required to look up, cancel, or reschedule the same booking record. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when isError=true. | |
| guests | No | Booked guest count. | |
| status | Yes | Host-node booking status. 'completed' is a protocol compatibility output only, not the active lifecycle truth. | |
| checkIn | No | Booked arrival date. | |
| checkOut | No | Booked departure date. | |
| currency | No | ISO 4217 currency code for the booking total. | |
| createdAt | No | Booking creation timestamp. | |
| guestName | No | Primary guest name stored on the booking. | |
| updatedAt | No | Last update timestamp for the booking record. | |
| guestEmail | No | Primary guest email stored on the booking. | |
| propertyId | No | Property UUID associated with the booking. | |
| totalPrice | No | Total amount in minor currency units. | |
| propertyName | No | Display name of the booked property. | |
| reservationId | Yes | Echoed booking or reservation UUID. | |
| propertyDomain | No | Host-owned domain associated with the property. | |
| cancellationPolicy | No | Host cancellation-policy details applicable to this booking. |