Search Hotels

This endpoint allows searching for hotels with location and hotelids.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Search: Response Keys

KeyDescription
traceIdUnique ID of search session
hotelIdUnique ID of the hotel
hotelNameHotel name
heroImageMain image of the hotel, meant for the search results card
boardBasisMeal plan of the rate shown for the hotel
refundabilityWhether the rate can be cancelled for free
cancellationPolicyCancellation terms for the rate, made up of one or more rules
finalRateFinal price of the hotel's lead rate for the hotel

Note: tags cannot be used on a fresh search — the internal tag IDs are only available from the /search API's own response. To filter by tags, you must first run a search without this filter, read the tag IDs off the results, and then re-search (or refine) passing those IDs back in filterBy.tags

Body Params

Search criteria for hotels.

date
required

The check-in date for the booking in YYYY-MM-DD format.

date
required

The check-out date for the booking in YYYY-MM-DD format.

string
required

The nationality of the person making the booking.

occupancies
array of objects
required

Details of the occupants in the booking.

occupancies*
string

The ID of the location where hotels are being searched.

hotelIds
array of strings

List of hotel IDs.

hotelIds
integer

Page number to request from the total paginated results.

integer

Number of hotel records to request in one page.

string

A unique identifier for tracking the request.

filterBy
object

To filter out search results

sortBy
object

Controls the order in which results are returned

Headers
string
required

Authorization token to authenticate the API request.

string
enum
required
Defaults to website

Specifies the source of the request (End User Source). Available choices: website, android, mweb, ios, mobile.

Allowed:
Responses

400

Bad Request. One or more request parameters are invalid or missing.

401

Unauthorized. The access token is missing or invalid.

404

Not Found. The requested resource could not be located.

422

Bad Request. Client Side Error in Request Body.

Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json