Search hotels, get live prices, and check out in chat. Guest search needs no sign-in.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add an item (hotel, activity, meal, etc.) to a saved trip on a given day.
Day number within the trip.
Item type.
Item title (1-255 chars).
The trip's public id (from `list_trips`/`save_trip`).
Order within the day (default 0).
Optional notes (≤2000 chars).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Add an item (hotel, activity, meal, etc.) to a saved trip on a given day.
| Argument | Type | Description |
|---|---|---|
| day* | integer | Day number within the trip. |
| type* | string | Item type. |
| title* | string | Item title (1-255 chars). |
| sortOrder | integer | Order within the day (default 0). |
| description | string | Optional notes (≤2000 chars). |
| itineraryPublicId* | string | The trip's public id (from `list_trips`/`save_trip`). |
{
"type": "object",
"required": [
"itineraryPublicId",
"day",
"type",
"title"
],
"properties": {
"day": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Day number within the trip."
},
"type": {
"enum": [
"hotel",
"experience",
"transfer",
"activity",
"meal",
"note"
],
"type": "string",
"description": "Item type."
},
"title": {
"type": "string",
"description": "Item title (1-255 chars)."
},
"sortOrder": {
"type": "integer",
"minimum": 0,
"description": "Order within the day (default 0)."
},
"description": {
"type": "string",
"description": "Optional notes (≤2000 chars)."
},
"itineraryPublicId": {
"type": "string",
"description": "The trip's public id (from `list_trips`/`save_trip`)."
}
},
"additionalProperties": false
}Cancel one of the signed-in user's bookings. Requires the 6-digit `verificationCode` from `request_booking_action_code`. This may be irreversible and can trigger a refund per policy.
| Argument | Type | Description |
|---|---|---|
| reason | string | Optional cancellation reason (≤1000 chars). |
| publicId* | string | The booking's public id. |
| verificationCode* | string | 6-digit code from `request_booking_action_code`. |
{
"type": "object",
"required": [
"publicId",
"verificationCode"
],
"properties": {
"reason": {
"type": "string",
"description": "Optional cancellation reason (≤1000 chars)."
},
"publicId": {
"type": "string",
"description": "The booking's public id."
},
"verificationCode": {
"type": "string",
"description": "6-digit code from `request_booking_action_code`."
}
},
"additionalProperties": false
}Create a secure checkout for a chosen hotel room and return a getmyhotels.com URL where the guest completes payment. This does NOT charge the card — the guest pays on the hosted page. Confirm the hotel, room, dates, and price with the user before calling. Call `get_checkout_quote` first to confirm the live price.
| Argument | Type | Description |
|---|---|---|
| ref | string | Hotel `ref` from `search_hotels` (e.g. 'TBO:1402689'). Alternative to supplierCode + supplierHotelId. |
| price* | number | Total to charge for the WHOLE stay (use `grandTotal` from `get_checkout_quote` verbatim — do not multiply it by the number of nights). |
| rooms | integer | Rooms (default 1). |
| adults | integer | Adults (default 2). |
| checkIn* | string | Check-in date, ISO 8601 (YYYY-MM-DD). |
| checkOut* | string | Check-out date, ISO 8601 (YYYY-MM-DD). |
| children | integer | Children (default 0). |
| currency* | string |
Create a checkout for the signed-in user with a saved card pre-selected, and return a getmyhotels.com URL where they confirm + pay in one click. Does NOT charge the card — the user confirms on the hosted page. Get the `savedPaymentMethodPublicId` from `list_payment_methods`. Confirm the hotel, room, dates, and price with the user first.
| Argument | Type | Description |
|---|---|---|
| ref | string | Hotel `ref` from `search_hotels` (e.g. 'TBO:1402689'). |
| price* | number | Total for the WHOLE stay (use `grandTotal` from `get_checkout_quote` verbatim — do not multiply it by the number of nights). |
| rooms | integer | Rooms (default 1). |
| adults | integer | Adults (default 2). |
| checkIn* | string | Check-in date, ISO 8601. |
| checkOut* | string | Check-out date, ISO 8601. |
| children | integer | Children (default 0). |
| currency* | string |
Fetch the full record for a result id returned by `search` (a hotel) or for a booking reference (prefixed 'bk_'). Returns a document with id, title, text, url, and metadata.
| Argument | Type | Description |
|---|---|---|
| id* | string | An id from `search` results, or a 'bk_'-prefixed booking ref. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "An id from `search` results, or a 'bk_'-prefixed booking ref."
}
},
"additionalProperties": false
}Look up a hotel booking by its management token (sent in the confirmation email). Returns the booking status, hotel, dates, and guest details.
| Argument | Type | Description |
|---|---|---|
| bookingToken* | string | The booking management token from the confirmation email/URL. |
{
"type": "object",
"required": [
"bookingToken"
],
"properties": {
"bookingToken": {
"type": "string",
"description": "The booking management token from the confirmation email/URL."
}
},
"additionalProperties": false
}Re-price a specific room live against the supplier before checkout (no booking, no charge). Use the `offerRef` and price/currency from `get_rooms`. Returns the authoritative grand total, a `rateValidUntil` timestamp, and any taxes/fees.
| Argument | Type | Description |
|---|---|---|
| ref | string | Hotel `ref` from `search_hotels` (e.g. 'TBO:1402689'). Alternative to supplierCode + supplierHotelId. |
| rooms | integer | Rooms (default 1). |
| adults | integer | Adults (default 2). |
| checkIn* | string | Check-in date, ISO 8601 (YYYY-MM-DD). |
| checkOut* | string | Check-out date, ISO 8601 (YYYY-MM-DD). |
| children | integer | Children (default 0). |
| currency* | string | ISO 4217 currency of `price`/`totalPrice` (e.g. 'USD'). |
| offerRef | string | Opaque room offer from get_rooms. |
| promoCode |
Get full property details (description, amenities, photos, policies, location) for a hotel, identified by its `ref` from `search_hotels` (or its supplierCode + supplierHotelId).
| Argument | Type | Description |
|---|---|---|
| ref | string | The hotel `ref` from search (e.g. 'tbo:1360717'). |
| rooms | integer | Rooms (default 1). |
| adults | integer | Adults (default 2). |
| checkIn | string | Check-in date, ISO 8601 (YYYY-MM-DD). Pass the guest's dates when known: some suppliers only return a hotel that has rooms for them. |
| checkOut | string | Check-out date, ISO 8601 (YYYY-MM-DD). |
| children | integer | Children (default 0). |
| supplierCode | string | Alternative to `ref`: supplier code. |
| supplierHotelId | string | Alternative to `ref`: supplier hotel id. |
{
"type": "object",
"properties": {
"ref": {
"type": "string",
"description": "The hotel `ref` from search (e.g. 'tbo:1360717')."
},
"rooms": {
"type": "integer",
"maximum": 9,
"minimum": 1,
"description": "Rooms (default 1)."
},
"adults": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Adults (default 2)."
},
"checkIn": {
"type": "string",
"description": "Check-in date, ISO 8601 (YYYY-MM-DD). Pass the guest's dates when known: some suppliers only return a hotel that has rooms for them."
},
"checkOut": {
"type": "string",
"description": "Check-out date, ISO 8601 (YYYY-MM-DD)."
},
"children": {
"type": "integer",
"maximum": 6,
"minimum": 0,
"description": "Children (default 0)."
},
"supplierCode": {
"type": "string",
"description": "Alternative to `ref`: supplier code."
},
"supplierHotelId": {
"type": "string",
"description": "Alternative to `ref`: supplier hotel id."
}
},
"additionalProperties": false
}Get full details of one of the signed-in user's bookings by its public id.
| Argument | Type | Description |
|---|---|---|
| publicId* | string | The booking's public id. |
{
"type": "object",
"required": [
"publicId"
],
"properties": {
"publicId": {
"type": "string",
"description": "The booking's public id."
}
},
"additionalProperties": false
}List the bookable rooms for ONE hotel and date range. Each room's `offerRef` is what you pass to `get_checkout_quote` / `create_checkout`. Use the hotel `ref` from `search_hotels` or `search`. Call this to see all of a chosen hotel's rooms, or to refresh availability before checkout.
| Argument | Type | Description |
|---|---|---|
| ref | string | The hotel `ref` from search (e.g. 'tbo:1360717'). |
| rooms | integer | Rooms (default 1). |
| adults | integer | Adults (default 2). |
| checkIn* | string | Check-in date, ISO 8601 (YYYY-MM-DD). |
| checkOut* | string | Check-out date, ISO 8601 (YYYY-MM-DD). |
| children | integer | Children (default 0). |
| supplierCode | string | Alternative to `ref`: supplier code. |
| supplierHotelId | string | Alternative to `ref`: supplier hotel id. |
List the signed-in user's hotel bookings.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number (default 1). |
| limit | integer | Page size (default 20). |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"description": "Page number (default 1)."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Page size (default 20)."
}
},
"additionalProperties": false
}List the signed-in user's saved payment cards (brand, last 4, expiry, default). Use the returned `publicId` with `create_one_click_checkout` to pre-select a card.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}List the signed-in user's saved trips (itineraries).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Change one of the signed-in user's bookings. Requires the 6-digit `verificationCode` from `request_booking_action_code`. Special-request edits always apply. A DATE change is pushed to the hotel supplier as a cancel-and-rebook at current availability, so it only works for suppliers that support amendment — for others (and when no room is available for the new dates) it returns an error asking you to cancel and rebook instead. A date change can shift the price and issue a new confirmation; the result's `supplierModifyStatus` says whether the supplier reservation was actually changed (`modified`), simulated (`simulated`), or the edit stayed local (`local_only`, e.g. special requests only). Never promise a date change went through unless `supplierModifyStatus` is `modified` or `simulated`.
| Argument | Type | Description |
|---|---|---|
| checkIn | string | New check-in date, ISO 8601 (optional). |
| checkOut | string | New check-out date, ISO 8601 (optional). |
| publicId* | string | The booking's public id. |
| specialRequests | string | New special requests (≤2000 chars, optional). |
| verificationCode* | string | 6-digit code from `request_booking_action_code`. |
{
"type": "object",
"required": [
"publicId",
"verificationCode"
],
"properties": {
"checkIn": {
"type": "string",
"description": "New check-in date, ISO 8601 (optional)."
},
"checkOut": {
"type": "string",
"description": "New check-out date, ISO 8601 (optional)."
},
"publicId": {
"type": "string",
"description": "The booking's public id."
},
"specialRequests": {
"type": "string",
"description": "New special requests (≤2000 chars, optional)."
},
"verificationCode": {
"type": "string",
"description": "6-digit code from `request_booking_action_code`."
}
},
"additionalProperties": false
}Email a 6-digit verification code to the booking owner, required before cancelling or modifying a booking. Step 1 of 2 — then call `cancel_booking`/`modify_booking` with the code.
| Argument | Type | Description |
|---|---|---|
| action* | string | Which action the code authorizes. |
| publicId* | string | The booking's public id. |
{
"type": "object",
"required": [
"publicId",
"action"
],
"properties": {
"action": {
"enum": [
"cancel",
"modify"
],
"type": "string",
"description": "Which action the code authorizes."
},
"publicId": {
"type": "string",
"description": "The booking's public id."
}
},
"additionalProperties": false
}Create a new saved trip (itinerary) for the signed-in user.
| Argument | Type | Description |
|---|---|---|
| title* | string | Trip title (1-255 chars). |
| budget | number | Optional total budget. |
| endDate* | string | Trip end, ISO 8601 (YYYY-MM-DD). |
| startDate* | string | Trip start, ISO 8601 (YYYY-MM-DD). |
| description | string | Optional notes (≤4000 chars). |
| budgetCurrency | string | ISO 4217 currency for the budget (e.g. 'USD'). |
{
"type": "object",
"required": [
"title",
"startDate",
"endDate"
],
"properties": {
"title": {
"type": "string",
"description": "Trip title (1-255 chars)."
},
"budget": {
"type": "number",
"description": "Optional total budget."
},
"endDate": {
"type": "string",
"description": "Trip end, ISO 8601 (YYYY-MM-DD)."
},
"startDate": {
"type": "string",
"description": "Trip start, ISO 8601 (YYYY-MM-DD)."
},
"description": {
"type": "string",
"description": "Optional notes (≤4000 chars)."
},
"budgetCurrency": {
"type": "string",
"description": "ISO 4217 currency for the budget (e.g. 'USD')."
}
},
"additionalProperties": false
}Search GetMyHotels for hotels matching a query. Returns a list of results with ids that can be passed to `fetch` for full details. Provide the destination and travel dates in the query.
| Argument | Type | Description |
|---|---|---|
| query* | string | Natural-language search, e.g. 'hotels in Lisbon 2026-08-10 to 2026-08-14 for 2 adults'. |
| rooms | integer | Rooms (1-6). Default 1. |
| adults | integer | Adults (1-10). Default 2. |
| checkIn | string | Check-in date, ISO 8601 (YYYY-MM-DD). |
| checkOut | string | Check-out date, ISO 8601 (YYYY-MM-DD). Must be after check-in. |
| children | integer | Children (0-6). Default 0. |
| keywords | string | Optional free-text preferences, e.g. 'beachfront pool spa'. |
| destination | string | City, region, or place to search (e.g. 'Paris', 'Goa', 'Lower Manhattan'). |
| childrenAges | array |
Search live hotel availability for a destination and date range. Returns a price-sorted list of hotels (JSON in the text), each with an opaque `ref` and an indicative stay price. To book: call `get_rooms` and pass the chosen room's `offerRef` to `get_checkout_quote` then `create_checkout`. For a hotel's other rooms (or a hotel not in the list), call `get_rooms`. Narrow with `keywords` (a hotel name, area, or amenities).
| Argument | Type | Description |
|---|---|---|
| rooms | integer | Rooms (1-6). Default 1. |
| adults | integer | Adults (1-10). Default 2. |
| checkIn* | string | Check-in date, ISO 8601 (YYYY-MM-DD). |
| checkOut* | string | Check-out date, ISO 8601 (YYYY-MM-DD). Must be after check-in. |
| children | integer | Children (0-6). Default 0. |
| keywords | string | Optional free-text preferences, e.g. 'beachfront pool spa'. |
| destination* | string | City, region, or place to search (e.g. 'Paris', 'Goa', 'Lower Manhattan'). |
| childrenAges |
| ISO 4217 currency of `price`/`totalPrice` (e.g. 'USD'). |
| offerRef | string | Opaque room offer from get_rooms. |
| roomName* | string | Room name (from the chosen room). |
| hotelName* | string | Hotel name (from `search_hotels`). |
| childrenAges | array | Age of each child. |
| supplierCode | string | Supplier code (from `search_hotels`). Required if `ref` is omitted. |
| supplierRoomId | string | Bookable room/rate id from the chosen room in `search_hotels`. |
| supplierHotelId | string | Supplier hotel id (from `search_hotels`). Required if `ref` is omitted. |
{
"type": "object",
"required": [
"hotelName",
"roomName",
"checkIn",
"checkOut",
"price",
"currency"
],
"properties": {
"ref": {
"type": "string",
"description": "Hotel `ref` from `search_hotels` (e.g. 'TBO:1402689'). Alternative to supplierCode + supplierHotelId."
},
"price": {
"type": "number",
"description": "Total to charge for the WHOLE stay (use `grandTotal` from `get_checkout_quote` verbatim — do not multiply it by the number of nights)."
},
"rooms": {
"type": "integer",
"maximum": 9,
"minimum": 1,
"description": "Rooms (default 1)."
},
"adults": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Adults (default 2)."
},
"checkIn": {
"type": "string",
"description": "Check-in date, ISO 8601 (YYYY-MM-DD)."
},
"checkOut": {
"type": "string",
"description": "Check-out date, ISO 8601 (YYYY-MM-DD)."
},
"children": {
"type": "integer",
"maximum": 6,
"minimum": 0,
"description": "Children (default 0)."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency of `price`/`totalPrice` (e.g. 'USD')."
},
"offerRef": {
"type": "string",
"description": "Opaque room offer from get_rooms."
},
"roomName": {
"type": "string",
"description": "Room name (from the chosen room)."
},
"hotelName": {
"type": "string",
"description": "Hotel name (from `search_hotels`)."
},
"childrenAges": {
"type": "array",
"items": {
"type": "integer",
"maximum": 18,
"minimum": 0
},
"description": "Age of each child."
},
"supplierCode": {
"type": "string",
"description": "Supplier code (from `search_hotels`). Required if `ref` is omitted."
},
"supplierRoomId": {
"type": "string",
"description": "Bookable room/rate id from the chosen room in `search_hotels`."
},
"supplierHotelId": {
"type": "string",
"description": "Supplier hotel id (from `search_hotels`). Required if `ref` is omitted."
}
},
"additionalProperties": false
}| ISO 4217 currency (e.g. 'USD'). |
| offerRef | string | Opaque room offer from get_rooms. |
| roomName* | string | Room name. |
| hotelName* | string | Hotel name. |
| supplierCode | string | Supplier code (if `ref` omitted). |
| supplierRoomId | string | Bookable room/rate id from `search_hotels`. |
| supplierHotelId | string | Supplier hotel id (if `ref` omitted). |
| savedPaymentMethodPublicId* | string | Saved card `publicId` from `list_payment_methods`. |
{
"type": "object",
"required": [
"savedPaymentMethodPublicId",
"hotelName",
"roomName",
"checkIn",
"checkOut",
"price",
"currency"
],
"properties": {
"ref": {
"type": "string",
"description": "Hotel `ref` from `search_hotels` (e.g. 'TBO:1402689')."
},
"price": {
"type": "number",
"description": "Total for the WHOLE stay (use `grandTotal` from `get_checkout_quote` verbatim — do not multiply it by the number of nights)."
},
"rooms": {
"type": "integer",
"maximum": 9,
"minimum": 1,
"description": "Rooms (default 1)."
},
"adults": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Adults (default 2)."
},
"checkIn": {
"type": "string",
"description": "Check-in date, ISO 8601."
},
"checkOut": {
"type": "string",
"description": "Check-out date, ISO 8601."
},
"children": {
"type": "integer",
"maximum": 6,
"minimum": 0,
"description": "Children (default 0)."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency (e.g. 'USD')."
},
"offerRef": {
"type": "string",
"description": "Opaque room offer from get_rooms."
},
"roomName": {
"type": "string",
"description": "Room name."
},
"hotelName": {
"type": "string",
"description": "Hotel name."
},
"supplierCode": {
"type": "string",
"description": "Supplier code (if `ref` omitted)."
},
"supplierRoomId": {
"type": "string",
"description": "Bookable room/rate id from `search_hotels`."
},
"supplierHotelId": {
"type": "string",
"description": "Supplier hotel id (if `ref` omitted)."
},
"savedPaymentMethodPublicId": {
"type": "string",
"description": "Saved card `publicId` from `list_payment_methods`."
}
},
"additionalProperties": false
}| string |
| Optional promo code. |
| totalPrice* | number | The room's price from `search_hotels` — the TOTAL for the whole stay, not a nightly rate (used to detect price changes). |
| childrenAges | array | Age of each child. |
| supplierCode | string | Supplier code (from `search_hotels`). Required if `ref` is omitted. |
| supplierRoomId | string | Bookable room/rate id from the chosen room in `search_hotels`. |
| supplierHotelId | string | Supplier hotel id (from `search_hotels`). Required if `ref` is omitted. |
{
"type": "object",
"required": [
"checkIn",
"checkOut",
"totalPrice",
"currency"
],
"properties": {
"ref": {
"type": "string",
"description": "Hotel `ref` from `search_hotels` (e.g. 'TBO:1402689'). Alternative to supplierCode + supplierHotelId."
},
"rooms": {
"type": "integer",
"maximum": 9,
"minimum": 1,
"description": "Rooms (default 1)."
},
"adults": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Adults (default 2)."
},
"checkIn": {
"type": "string",
"description": "Check-in date, ISO 8601 (YYYY-MM-DD)."
},
"checkOut": {
"type": "string",
"description": "Check-out date, ISO 8601 (YYYY-MM-DD)."
},
"children": {
"type": "integer",
"maximum": 6,
"minimum": 0,
"description": "Children (default 0)."
},
"currency": {
"type": "string",
"description": "ISO 4217 currency of `price`/`totalPrice` (e.g. 'USD')."
},
"offerRef": {
"type": "string",
"description": "Opaque room offer from get_rooms."
},
"promoCode": {
"type": "string",
"description": "Optional promo code."
},
"totalPrice": {
"type": "number",
"description": "The room's price from `search_hotels` — the TOTAL for the whole stay, not a nightly rate (used to detect price changes)."
},
"childrenAges": {
"type": "array",
"items": {
"type": "integer",
"maximum": 18,
"minimum": 0
},
"description": "Age of each child."
},
"supplierCode": {
"type": "string",
"description": "Supplier code (from `search_hotels`). Required if `ref` is omitted."
},
"supplierRoomId": {
"type": "string",
"description": "Bookable room/rate id from the chosen room in `search_hotels`."
},
"supplierHotelId": {
"type": "string",
"description": "Supplier hotel id (from `search_hotels`). Required if `ref` is omitted."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"checkIn",
"checkOut"
],
"properties": {
"ref": {
"type": "string",
"description": "The hotel `ref` from search (e.g. 'tbo:1360717')."
},
"rooms": {
"type": "integer",
"maximum": 9,
"minimum": 1,
"description": "Rooms (default 1)."
},
"adults": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Adults (default 2)."
},
"checkIn": {
"type": "string",
"description": "Check-in date, ISO 8601 (YYYY-MM-DD)."
},
"checkOut": {
"type": "string",
"description": "Check-out date, ISO 8601 (YYYY-MM-DD)."
},
"children": {
"type": "integer",
"maximum": 6,
"minimum": 0,
"description": "Children (default 0)."
},
"supplierCode": {
"type": "string",
"description": "Alternative to `ref`: supplier code."
},
"supplierHotelId": {
"type": "string",
"description": "Alternative to `ref`: supplier hotel id."
}
},
"additionalProperties": false
}| Age of each child at check-in. Length should equal `children`. |
| guestNationality | string | ISO 3166-1 alpha-2 guest nationality (e.g. 'US', 'GB'). Affects supplier pricing. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Natural-language search, e.g. 'hotels in Lisbon 2026-08-10 to 2026-08-14 for 2 adults'."
},
"rooms": {
"type": "integer",
"maximum": 6,
"minimum": 1,
"description": "Rooms (1-6). Default 1."
},
"adults": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Adults (1-10). Default 2."
},
"checkIn": {
"type": "string",
"description": "Check-in date, ISO 8601 (YYYY-MM-DD)."
},
"checkOut": {
"type": "string",
"description": "Check-out date, ISO 8601 (YYYY-MM-DD). Must be after check-in."
},
"children": {
"type": "integer",
"maximum": 6,
"minimum": 0,
"description": "Children (0-6). Default 0."
},
"keywords": {
"type": "string",
"description": "Optional free-text preferences, e.g. 'beachfront pool spa'."
},
"destination": {
"type": "string",
"description": "City, region, or place to search (e.g. 'Paris', 'Goa', 'Lower Manhattan')."
},
"childrenAges": {
"type": "array",
"items": {
"type": "integer",
"maximum": 17,
"minimum": 0
},
"description": "Age of each child at check-in. Length should equal `children`."
},
"guestNationality": {
"type": "string",
"description": "ISO 3166-1 alpha-2 guest nationality (e.g. 'US', 'GB'). Affects supplier pricing."
}
},
"additionalProperties": false
}| array |
| Age of each child at check-in. Length should equal `children`. |
| guestNationality | string | ISO 3166-1 alpha-2 guest nationality (e.g. 'US', 'GB'). Affects supplier pricing. |
{
"type": "object",
"required": [
"destination",
"checkIn",
"checkOut"
],
"properties": {
"rooms": {
"type": "integer",
"maximum": 6,
"minimum": 1,
"description": "Rooms (1-6). Default 1."
},
"adults": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Adults (1-10). Default 2."
},
"checkIn": {
"type": "string",
"description": "Check-in date, ISO 8601 (YYYY-MM-DD)."
},
"checkOut": {
"type": "string",
"description": "Check-out date, ISO 8601 (YYYY-MM-DD). Must be after check-in."
},
"children": {
"type": "integer",
"maximum": 6,
"minimum": 0,
"description": "Children (0-6). Default 0."
},
"keywords": {
"type": "string",
"description": "Optional free-text preferences, e.g. 'beachfront pool spa'."
},
"destination": {
"type": "string",
"description": "City, region, or place to search (e.g. 'Paris', 'Goa', 'Lower Manhattan')."
},
"childrenAges": {
"type": "array",
"items": {
"type": "integer",
"maximum": 17,
"minimum": 0
},
"description": "Age of each child at check-in. Length should equal `children`."
},
"guestNationality": {
"type": "string",
"description": "ISO 3166-1 alpha-2 guest nationality (e.g. 'US', 'GB'). Affects supplier pricing."
}
},
"additionalProperties": false
}