Hermeseus API

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.

Read the guide API reference

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

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.