Direct RoomsRates API

The Direct Rooms & Rates API fetches rooms and rates for a specific hotel without needing a search token. Instead of going through Search Init first, you pass the hotel ID and full search criteria directly. The response structure is identical to the standard Rooms & Rates API — everything from here to booking works the same way.

POST{baseEndpoint}/api/hotel/{hotelId}/roomsandrates/direct

When to use this instead of the standard flow

🏨 Hotel detail pages

A user lands directly on a hotel page via a link or bookmark. You already know the hotel ID — no need to run a full location search first.

📣 Promotions

You want to feature a specific property on your homepage or in a campaign. Load its rates directly without requiring a search interaction.

🔗 Deep links

A user arrives via an external link that includes a hotel ID and dates. Take them straight to room selection — skip the search step entirely.

🔄 Rate refresh

You need to re-check rates for a hotel the user was previously viewing, without restarting the full search flow.

Standard flow vs direct — what changes

Standard Rooms & Rates

Requires a search token

You must run Search Init first. The token carries the search context so you don't re-send dates and occupancy in downstream calls.

Direct Rooms & Rates

No token needed

Pass the hotel ID, check-in/check-out dates, and occupancy directly in the request body. Everything else — response structure, Price API, Book API — works identically.

Identical response structure. The five objects — rooms, rates, recommendations, standardisedRooms, standardisedRoomGroups — are exactly the same as the standard Rooms & Rates response. Use standardisedRoomGroups as your primary data source here as well.