Get Rooms
Retrieve available room types and rates for a hotel.
Get Rooms
Retrieve available room types and rates for a specific hotel property, then confirm a price before committing to a booking.
List Rooms
POST /v1/hotel/rooms
Returns available room types and rate plans for the given hotel and stay dates. Each room includes rate breakdown, cancellation policy, and board type.
| Field | Type | Required | Description |
|---|---|---|---|
hotel_id | string | yes | Hotel identifier returned from search. |
check_in | string | yes | Check-in date in YYYY-MM-DD format. |
check_out | string | yes | Check-out date in YYYY-MM-DD format. |
guests.adults | integer | yes | Number of adult guests. |
guests.rooms | integer | yes | Number of rooms requested. |
https://cloud.vanitypass.com with X-Environment: Sandbox. No real bookings or charges. Production access: contact us./v1/hotel/roomsSandbox 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/rooms' \
-H 'Content-Type: application/json' \
-H 'X-Environment: Sandbox' \
-d '{"hotel_id":"htl_example","check_in":"2026-07-01","check_out":"2026-07-03","guests":{"adults":2,"rooms":1}}'Confirm Price
POST /v1/hotel/confirm-price
Lock in the rate for a specific room before booking. Call this immediately before initiating a booking to ensure the quoted price is still valid. Returns a price confirmation token valid for a short window.
| Field | Type | Required | Description |
|---|---|---|---|
room_id | string | yes | Room identifier from the rooms response. |
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/confirm-priceSandbox 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/confirm-price' \
-H 'Content-Type: application/json' \
-H 'X-Environment: Sandbox' \
-d '{"room_id":"room_example","hotel_id":"htl_example"}'