v16

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-04121623.5 KB

Hotels

Search bookable hotel rates

Search real, bookable hotel inventory.

Only free-cancellation, pay-later rates are returned — those are the rates where the guest's balance can safely be settled with the supplier after booking, which is what makes the 10%-now/rest-later model work. The result set is therefore smaller than a metasearch's, and every row in it can actually be booked.

price is what the guest pays. There is no wholesale figure in the response to quote by mistake. Keep session_id and the chosen offer's combination_id_v2 — together they identify that exact rate, and booking needs both.

A payment method on file is required for search, not just booking: a search opens a real session at the supplier.

post/api/v1/hotels/search

Request body

city_idinteger required

city_namestring required

check_instring date required

check_outstring date required

adultsinteger

childreninteger

child_agesinteger[]

Required by the supplier to price children.

nationalitystring

Two-letter code. Rates and taxes genuinely differ by nationality.

limitinteger

Example request

{
  "city_id": 148614,
  "city_name": "Warsaw, Poland",
  "check_in": "2026-11-10",
  "check_out": "2026-11-12"
}

Response

Hotels with bookable offers