Hotel Details & Search Helpers
Fetch full hotel information, autocomplete destinations, validate bookings, and update traveller details.
Hotel Details & Search Helpers
Supporting endpoints for enriching hotel search results, validating bookings, and managing traveller information.
Hotel Details
POST /v1/hotel/details
Get full hotel info: photos, amenities, policies, location.
| Field | Type | Required | Description |
|---|---|---|---|
hotel_id | string | yes | Hotel identifier. |
https://cloud.vanitypass.com with X-Environment: Sandbox. No real bookings or charges. Production access: contact us./v1/hotel/detailsSandbox credentials
Keys never leave your browser — they are sent only to cloud.vanitypass.com with X-Environment: Sandbox.
curl -X POST 'https://cloud.vanitypass.com/v1/hotel/details' \
-H 'Content-Type: application/json' \
-H 'X-Environment: Sandbox' \
-d '{"hotel_id":"htl_example"}'Auto-Suggestion
POST /v1/hotel/auto-suggestion
Autocomplete destinations and hotel names. Use this to power search-as-you-type inputs. Returns a list of matching destinations, cities, and hotel names with their identifiers.
| Field | Type | Required | Description |
|---|---|---|---|
location | string | yes | Partial destination or hotel name to search. |
https://cloud.vanitypass.com with X-Environment: Sandbox. No real bookings or charges. Production access: contact us./v1/hotel/auto-suggestionSandbox credentials
Keys never leave your browser — they are sent only to cloud.vanitypass.com with X-Environment: Sandbox.
curl -X POST 'https://cloud.vanitypass.com/v1/hotel/auto-suggestion' \
-H 'Content-Type: application/json' \
-H 'X-Environment: Sandbox' \
-d '{"location":"New York"}'Auto-Suggestion (V2)
POST /v1/hotel/auto-suggestion/v2
Enhanced auto-suggestion that returns richer hotel metadata and accepts an optional language for localized results. Prefer V2 for new integrations; V1 remains available for backwards compatibility.
| Field | Type | Required | Description |
|---|---|---|---|
location | string | yes | Partial destination or hotel name to search. |
language | string | no | ISO-639-1 language code for results (default: en). |
https://cloud.vanitypass.com with X-Environment: Sandbox. No real bookings or charges. Production access: contact us./v1/hotel/auto-suggestion/v2Sandbox credentials
Keys never leave your browser — they are sent only to cloud.vanitypass.com with X-Environment: Sandbox.
curl -X POST 'https://cloud.vanitypass.com/v1/hotel/auto-suggestion/v2' \
-H 'Content-Type: application/json' \
-H 'X-Environment: Sandbox' \
-d '{"location":"New York","language":"en"}'Validate Booking
POST /v1/hotel/validate
Validate a booking request before submission. Checks room availability, guest counts, and policy compliance. Call this before initiating a booking to surface any issues early.
| Field | Type | Required | Description |
|---|---|---|---|
room_id | string | yes | Room identifier. |
hotel_id | string | yes | Hotel identifier. |
guests.adults | integer | yes | Number of adult guests. |
https://cloud.vanitypass.com with X-Environment: Sandbox. No real bookings or charges. Production access: contact us./v1/hotel/validateSandbox credentials
Keys never leave your browser — they are sent only to cloud.vanitypass.com with X-Environment: Sandbox.
curl -X POST 'https://cloud.vanitypass.com/v1/hotel/validate' \
-H 'Content-Type: application/json' \
-H 'X-Environment: Sandbox' \
-d '{"room_id":"room_example","hotel_id":"htl_example","guests":{"adults":2}}'Update Travellers
POST /v1/hotel/update-travellers
Save or update traveller/passenger info for a booking. Call this after initiating a booking to attach guest details required by the property.
| Field | Type | Required | Description |
|---|---|---|---|
booking_id | string | yes | Booking identifier from the initiate response. |
travellers | array | yes | List of traveller objects. |
travellers[].first_name | string | yes | Traveller's first name. |
travellers[].last_name | string | yes | Traveller's last name. |
travellers[].passport | string | no | Passport number (required by some properties). |
https://cloud.vanitypass.com with X-Environment: Sandbox. No real bookings or charges. Production access: contact us./v1/hotel/update-travellersSandbox credentials
Keys never leave your browser — they are sent only to cloud.vanitypass.com with X-Environment: Sandbox.
curl -X POST 'https://cloud.vanitypass.com/v1/hotel/update-travellers' \
-H 'Content-Type: application/json' \
-H 'X-Environment: Sandbox' \
-d '{"booking_id":"book_example","travellers":[{"first_name":"Jane","last_name":"Doe","passport":"AB1234567"}]}'Weekly Recommendations
GET /v1/hotel/recommendations
Curated weekly hotel recommendations. Returns a curated list of featured hotels updated each week. Useful for populating landing pages and discovery surfaces.
https://cloud.vanitypass.com with X-Environment: Sandbox. No real bookings or charges. Production access: contact us./v1/hotel/recommendationsSandbox credentials
Keys never leave your browser — they are sent only to cloud.vanitypass.com with X-Environment: Sandbox.
curl -X GET 'https://cloud.vanitypass.com/v1/hotel/recommendations' \ -H 'Content-Type: application/json' \ -H 'X-Environment: Sandbox' \