Accommodation API for hotel search and booking
Add hotel search, live rates, and booking to your site. Resolve a destination, list properties, validate the rate, and confirm, all from one REST API.
What it solves
Hotel inventory is large and rates move fast. This accommodation API gives you a public place search, availability in city and hotel modes, rate validation with a hold window, and a clear book-then-confirm flow, with prices in USD.
What you get
- Public place search wires straight into a type-ahead box.
- One availability endpoint lists a city or opens a single hotel.
- Validate the rate, hold the room, then confirm and charge.
One request to start
curl -X POST https://api.hermeseus.com/api/v2/Hotel/HotelAvailability \
-H "Content-Type: application/json" \
-d '{
"SessionId": "...",
"CheckIn": "2026-10-15",
"CheckOut": "2026-10-16",
"CityId": 11111111456928,
"Occupancies": [ { "AdultCount": 2 } ],
"Sort": "price"
}'
Read the getting started guide to send your first authenticated request in five minutes.
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.
Is there a sandbox?
Yes. Search and rates are real, and the order call is simulated against a separate wallet.