menu

HotelSearch Details

This method is used to request room availability. Some filters and special features can be applied before sending an availability request.

Note- You have to send parallel searches for 100 hotel codes chunks in each search request for a particular city.

Service URL (REST) to be used:

https://affiliate.tektravels.com/HotelAPI/Search

GetHotelResult Request

This method is used to request room availability. Some filters and special features can be applied before sending an availability request.

Level Element Format Comments
CheckIn String Check-In date of the stay. Format: YYYY-MM-DD
CheckOut String Check-Out date of the stay. Format YYYY-MM-DD
HotelCodes String List of TBO codes of the requested hotels (comma separated list) Recommended Value; 100 hotel codes
GuestNationality String Lead guest nationality (in ISO 3166-1 alpha-2 letter country codes) E.g., United Arab Emirates – AE, Turkey – TR (If Guest is resident of UAE and searching for UAE hotels then guest can send his nationality as AE)
NoOfRooms Integer Filter for the maximum number of rooms the client wants to receive in the response.
PaxRooms; Array Contains an array of occupancy for each room
Adults Integer Number of Adult guests (1-8) per room
Children Integer Number of Child guests (1-4) per room
ChildrenAges Integer (Array) List of children ages (0-18 years). The length of array is equal to the number of children in the room. E.g.: [2, 8] if request contains 2 children.
ResponseTime Integer Expected response time (seconds)
IsDetailedResponse Boolean To get additional details in the search response like the day-wise break-up and detailed cancel policies. Default Value; False
Filters; Object Refine the search response
Refundable Boolean Set it True in case only Refundable rooms are required. Default Value; False
MealType Enumeration Filter response based on available meals. Possible Values. All, WithMeal and RoomOnly
GetHotelResult Response
Level Element Format Comments
Parameter  Type  Description 
Status;  Object 
Code  Integer  Internal code to denote response status. 
Description  String  Descriptive message. 
HotelResult  Array  Information regarding the hotels 
HotelCode  String  TBOH hotel code 
Currency  String  Configured currency in the API profile of the client. 
Room(s);  Array  Contains a list of bookable rooms 
Name  Array of String  Contain the list of room name. In case of multiple rooms first element represents the first room and so on. 
BookingCode  String  Unique Identifier for each bookable unit. 
Inclusion  String  Inclusion associated with rooms if any 
DayRates;  List of Array  Displays price breakdown per each day of the hotel stay. 
BasePrice  Decimal  BasePrice of the room. 
TotalFare  Decimal  Total fare of the bookable unit without TDS/TCS 
TotalTax  Decimal  Total tax of the bookable unit without TDS/TCS 
RoomID Integer  Used to map room details with Hote Details method to map room details 
ExtraGuestCharges  Decimal  Extra Guest charges of the bookable unit (if applicable) 
RecommendedSellingRate  String  The minimum selling rate for the requested booking. The B2C client cannot sell the room at a rate lower than the RecommendedSellingRate returned in the response, if any. 
RoomPromotion  List of String Array  List of promotions on the rate. In the case of multi- room, first element defines promotion for the first room, other respectively 
CancelPolicies;  Array  It contains the list of detailed cancel policies applicable on the bookable unit. 
Index  String  Denotes the room index for which cancellation policies is applicable. If missing, policies are applicable for entire booking 
FromDate  String  Cancel policy start date 
ChargeType  String  Charge type for cancellation policies e.g., fixed amount, percentage value etc. 
CancellationCharge  Decimal  Cancellation charges applicable on bookable unit. 
MealType  Enumeration  This reflects the meal type for the rate.Possible Values: Breakfast_For_2 ,Breakfast_For_1, All_Inclusive_All_Meal 
IsRefundable  Boolean  Defines refundable and non-refundable room. 
WithTransfers  Boolean  Defines if transfers are included. 
Supplements  List of Object  It contains list of supplements. Please ensure some are visible to end customer. 
Index  Integer  Denotes the room index for which supplement is applicable. 
Type  String  Supplement charge type Possible Values. 
Included: price included in total, 
AtProperty: charges need to be paid at the hotel. 
Description  String  Supplement details 
Price  Decimal  Supplement charges 
Currency  String  The applicable currency for the supplement charges.