Hotels

post

https://hms-api-sandbox.travclan.com/hms/external/api/v1/hotels/search

This endpoint allows searching for hotels with customizable sorting and filtering options. Please switch to HMS Domain.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Search criteria for hotels.

checkIn

date

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

checkOut

date

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

filterBy

object

Filters to refine the hotel search results.

nationality

string

The nationality of the person making the booking.

occupancies

array of objects

required

Details of the occupants in the booking.

occupancies*

locationId

integer

The ID of the location where hotels are being searched.

hotelIds

array of strings

List of hotel IDs.

hotelIds

sortBy

object

Sorting criteria for the search results.

page

integer

The page number for paginated results.

traceId

string

A unique identifier for tracking the request.

Headers

Authorization

string

required

Authorization token to authenticate the API request.

Authorization-Type

string

required

Defaults to external-service

Specifies the type of authorization, here it is set to external-service.

source

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. The hotelId parameter is invalid or missing.

401

Unauthorized. The access token is missing or invalid.

404

Not Found. The specified hotelId does not exist.

422

Bad Request. Client Side Error in Request Body.

200A successful response containing hotel search results.