Hotel search, rates, and booking
Resolve a destination, list properties, validate the rate, and confirm. One REST flow, prices in USD.
{
"CheckIn": "2026-11-14",
"CheckOut": "2026-11-16",
"CityId": 11111111456928,
"Occupancies": [ { "AdultCount": 2 } ],
"Sort": "price"
}Hotel inventory is vast and rates move fast. This accommodation API gives you public place search, availability in city and hotel modes, rate validation with a hold window, and a clear book-then-confirm flow.
One accommodation API stands in front of millions of properties, from global chains to independent boutiques. Availability, board types, cancellation policies, and taxes arrive in a single shape and currency, so your hotel booking website or app never has to reconcile a dozen supplier formats.
What you get
Public place search wires straight into a type-ahead box.
One availability endpoint lists a whole city or opens a single hotel with its rooms.
Validate the rate, hold the room, then confirm and charge, all in USD.
City and hotel search from one endpoint, from a whole destination down to a single property.
Rate validation opens a short hold window, so the price you show is the price you book.
How the flow works
Resolve
Turn a destination string into a place id with public place search.
Search
List availability for a whole city, or open a single property with its rooms.
Validate
Confirm the live rate and open a short hold window.
Book
Place the order and confirm; your balance is charged on confirmation.
Key endpoints
/Hotel/PlaceSearchResolve a destination into a place id./v2/Hotel/HotelAvailabilityList availability in city or hotel mode./Hotel/RateValidateValidate the selected rate and hold it./Hotel/HotelBookCreate and confirm the booking./Hotel/BookingDetailsRetrieve a booking and its status.Request and response
{
"CheckIn": "2026-11-14",
"CheckOut": "2026-11-16",
"CityId": 11111111456928,
"Occupancies": [ { "AdultCount": 2 } ],
"Sort": "price"
}{
"hotels": [
{
"hotelId": "HTL-9931",
"name": "Marina Suites",
"stars": 4,
"lowestRate": {
"amount": 180.00, "currency": "USD", "board": "BB"
},
"rooms": [ { "code": "DLX-K", "refundable": true } ]
}
]
}What the response includes
hotelId- Stable id for the property.
lowestRate- Cheapest bookable rate, in USD, with board type.
rooms- Room options with codes and refundability.
cancellationPolicy- Deadlines and penalties that apply to the rate.
hold- Minutes the validated rate stays bookable.
Hotels worldwide
Frequently asked questions
How do I turn a destination into a search?
Call the public place search to resolve the text into an id, then pass that id to availability.
How long is a validated rate good for?
Fifteen minutes. Book within that window with the returned fare code.
When is my balance charged?
Only when you place the order. Book holds the room without charging.
Do rates include taxes and fees?
Yes. Each rate carries the currency, board type, and a tax and fee breakdown, all normalized to USD.
Can I open a single property directly?
Yes. Hotel mode opens one property with its rooms, while city mode lists a whole destination.
Build your travel product on one API.
Free to integrate. 1% per issued ticket, capped at $10. Live coverage across flights, hotels, and activities.