Availability
The Availability API has been designed to provide list of all Hotels The following sectionsdescribe the hotellistsearch API request and response format.Currency set up done only onceaccount is created and you have to use that Currencyfor transaction with api.
Note : To get hotel list you need to pass isshowroom = 0 and then to get perticular hotel's all rooms you need to pass hotelid and isshowrrom = 1.
Request
baseurl/api/xconnect/Availability/Parent Tag | Tag | Description | Optionality |
---|
| Room | An array represents Room | Mandatory |
| RoomNo | Represents RoomNo | Mandatory |
| NoofAdults | Represents total number of Adults | Mandatory |
| NoOfChild | Represents total number of child. | Mandatory |
| ChildAge | Array represents child Age. | Mandatory |
| CityID | Represents unique CityID. | Mandatory |
| Nationality | Represents unique Nationality. | Mandatory |
| CheckInDate | Represents CheckInDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018 | Mandatory |
| CheckOutDate | Represents CheckOutDate. Date should be in the format: MM-DD-YYYY Example: 08-12-2018 | Mandatory |
| NoofNights | Represents number of Nights | Mandatory |
| currency | Represents currency | Mandatory |
| IsShowRooms | 1 Show Rooms 0 HotelOnly | Mandatory |
| IsRecommendedOnly | 1 Only Preferred Hotels 0 All Hotels | Mandatory |
| IsOnlyAvailable | 1 Available only 0 Include Onrequest | Mandatory |
| StarRating | Selection of star rating between two categories. | |
| Min | min=min star rating | 0 star rating for unspecifiedor apartment |
| max | max=max star rating | Mandatory |
| HotelIDs | Represents list of comma seperated HotelIDs by city | Optional |
Tag | Description |
---|
Count | Represents Count. |
SearchKey | SearchKey will use in next steps ,expires after 25 minutes. You haveto do booking within that time limits. |
Start price | Represents unique Price |
HotelID | Represents unique Hotel id |
HotelCode | Represents unique hotel code |
Currency | Represents Currency. |
Hoteloption | Array display detail. |
HoteloptionId | Represents unique hoteloptionid |
MinPrice | Represent Min Price |
IsCombined | True = Multiple roomsare combined in one False = receive list of rooms |
HotelRooms | Array display details |
RoomNo | Represents room number. You will get some combine rooms for multiplerooms search. |
RoomTypeName | Represents room type |
MealName | Represents MealName |
Price | Represents Price |
BookingStatus | Represents BookingStatus. |
RoomToken | It display unique AvailToken which is provided by the system |
Note :
As we have both direct inventories and dynamic rates also so for some cases you will receive combined room in multiple room search ,so for easy to identify these rates we have now added new parameter in availability response IsCombined (true,false) if its true then rooms are combined to one room .
for example : if search is for
rooms :2
room 1 : 1 adult
room 2 : 2 adult
then id IsCombined =true that means both rooms are combined in one (roomNo: "1") ;if False : then you recieve list of rooms(RoomNo:1,RoomNo:2) and when you try to book such combined room you have to pass pax details separately for boththe rooms.