Lookup
8 min
introduction the lookup method allows users to retrieve details of a specific reservation by passing in a reservation reference number request endpoint {{endpoint lookup}} element group element name type required element description lookupreservationrequest lookupreservationrequest group yes lookupreservationrequest timestamp attribute yes the current timestamp (yyyymmddthh🇲🇲ss) lookupreservationrequest version attribute no optional, but must exist and be set to 2 in order to see the v2 output lookupreservationrequest control group yes control username element yes your username control password element yes your password lookupreservationrequest referenceno element yes bonotel reference # response primary reservation data element group element name type req element description lookupreservationresponse lookupreservationresponse group yes lookupreservationresponse status attribute yes status of the response valid values are y – reservation lookup processed successfully n – reservation lookup error reservationdetails reservationdetails group yes reservationdetails referenceno element yes internal reference no sent by bonotel at the time of booking reservationdetails hotelconfirmation element yes the hotel’s confirmation number reservationdetails touroperatorname element yes tour operator name reservationdetails touroperatorordernumber element yes reference number of the tour operator booking reservationdetails hotelcode group yes internal hotel code of the booking reservationdetails hotelname attribute yes name of the hotel reservationdetails reservationsource element yes booking channel which booking has made xml via xml interface call center via bonotel call center web via bonotel website reservationdetails reservationstatus element yes current status of the booking normal booking remains unchanged modified booking has been modified by bonotel cancelled booking has been cancelled reservationdetails cancellationinfo group yes cancellation information cancellationinfo cancellationno element yes cancellation no cancellationinfo cancellationfee element yes applied cancellation fee reservationdetails confirmationtype element yes status notifying whether this is "con" – confirm "req" on request reservationdetails reservationdate element yes the date of the booking reservationdetails checkin element yes check in date reservationdetails checkout element yes check out date reservationdetails noofrooms element yes no of rooms booked reservationdetails noofnights element yes no of nights booked reservationdetails totalnoofadults attribute yes total number of adults for the booking reservationdetails totalnoofchildren element yes total number of children for the booking reservationdetails total element yes the total value of this reservation (including taxes) total currency attribute yes the currency of the total reservation reservationdetails totaltax element yes the total tax associated with the reservation totaltax currency element yes the currency of the tax reservationdetails roomdata group yes the room’s details, this should be repeated up to the no of rooms room data element group element name type req element description roomdata roomno element yes the room no of the booking roomdata roomresno element yes the room id assigned by bonotel roomdata roomcode element yes the room code assigned by bonotel roomdata roomtype element yes the room type name of the booked room roomdata roomtypecode element yes the room type code of the booked room roomdata bedtype element yes the bed type name of the booked room roomdata bedtypecode element yes the bed type code of the booked room roomdata rateplan element yes the rate plan name of the booked room roomdata rateplancode element yes the rate plan code of the booked room roomdata noofadults element yes no of adults of the booked room roomdata noofchildren element no no of children of the booked room roomdata occupancy group yes occupancy details are wrapped with in this group occupancy guest group yes occupancy group of the booked room note that the no of adults and children should be represented by this occupancy guest title element yes title of the guest, applicable only for adults list of titles \["dr ", "prof ", "mstr ", "mr ", "miss ", "ms ", "mrs ", "mr/mrs "] guest firstname element yes first name of the guest guest lastname element yes last name of the guest reservationdetails comment group yes comment customer element no any comments from the customer code example request {{endpoint lookup}} \<?xml version="1 0" encoding="utf 8" ?> \<lookupreservationrequest timestamp="20150325t14 01 29 " version="2"> 	\<control> 	 \<username>{{username}}\</username> 	 \<password>{{password}}\</password> 	\</control> 	\<referenceno>123456789x\</referenceno> \</lookupreservationrequest> response \<?xml version="1 0" encoding="utf 8" ?> \<lookupreservationresponse status="y" xmlns\ xsi="http //www w3 org/2001/xmlschema instance"> 	\<reservationdetails> 	 \<referenceno>354324117x\</referenceno> 	 \<hotelconfirmation>6c3ee91a 54c0 4499 a8cb df54dbcb14c8\</hotelconfirmation> 	 \<touroperatorname>my travel company\</touroperatorname> 	 \<touroperatorordernumber>654321\</touroperatorordernumber> 	 \<hotelcode>1343\</hotelcode> 	 \<hotelname>aria resort and casino\</hotelname> 	 \<reservationsource>xml\</reservationsource> 	 \<reservationstatus>normal\</reservationstatus> 	 \<cancellationinfo> 	 \<cancellationno/> 	 \<cancellationfee/> 	 \<cancellationtimestamp/> 	 \</cancellationinfo> 	 \<confirmationtype>con\</confirmationtype> 	 \<reservationtimestamp>2017 01 19t03 53 43+00 00\</reservationtimestamp> 	 \<modificaitontimestamp/> 	 \<checkin>22 apr 2017\</checkin> 	 \<checkout>24 apr 2017\</checkout> 	 \<noofrooms>2\</noofrooms> 	 \<noofnights>2\</noofnights> 	 \<totalnoofadults>1\</totalnoofadults> 	 \<totalnoofchildren>1\</totalnoofchildren> 	 \<total currency="usd">1274 88\</total> 	 \<totaltax currency="usd">0 00\</totaltax> 	 \<roomdata> 	 \<roomno>1\</roomno> 	 \<roomresno>57467147\</roomresno> 	 \<roomcode>5943\</roomcode> 	 \<roomtype>deluxe king\</roomtype> 	 \<roomtypecode>74\</roomtypecode> 	 \<bedtype>double\</bedtype> 	 \<bedtypecode>10\</bedtypecode> 	 \<rateplan>room only\</rateplan> 	 \<rateplancode>1\</rateplancode> 	 \<noofadults>1\</noofadults> 	 \<noofchildren>1\</noofchildren> 	 \<childages> 	 \<childage>4\</childage> 	 \</childages> 	 \<occupancy> 	 \<guest> 	 \<title>mr\</title> 	 \<firstname>testfirst1n\</firstname> 	 \<lastname>testlast1n\</lastname> 	 \</guest> 	 \<guest> 	 \<title>mr \</title> 	 \<firstname>testfirst2n\</firstname> 	 \<lastname>testlast2n\</lastname> 	 \</guest> 	 \</occupancy> 	 \<roombookingpolicy> 	 \<policyfrom>2008 04 01\</policyfrom> 	 \<policyto>2018 12 29\</policyto> 	 \<amendmenttype>cancel\</amendmenttype> 	 \<policybasedon>percentage\</policybasedon> 	 \<policybasedonvalue>100\</policybasedonvalue> 	 \<cancellationtype>normal\</cancellationtype> 	 \<staydaterequirement>n\</staydaterequirement> 	 \<arrivalrange>less than\</arrivalrange> 	 \<arrivalrangevalue>4\</arrivalrangevalue> 	 \<policyfee>$1175 52\</policyfee> 	 \<noshowbasedon>percentage\</noshowbasedon> 	 \<noshowbasedonvalue>100\</noshowbasedonvalue> 	 \<noshowpolicyfee>$1175 52\</noshowpolicyfee> 	 \</roombookingpolicy> 	 \<hotelfees> 	 \<hotelfee> 	 \<feetype>resort\</feetype> 	 \<feemethod>exclusive\</feemethod> 	 \<requiredfee>yes\</requiredfee> 	 \<feeassign>per room\</feeassign> 	 \<feefrequency>per night\</feefrequency> 	 \<feebasedon>val\</feebasedon> 	 \<feebasedonvalue>39 0\</feebasedonvalue> 	 \<salestax>13 38\</salestax> 	 \<conditions/> 	 \<feetotal>309 53\</feetotal> 	 \</hotelfee> 	 \</hotelfees> 	 \</roomdata> 	 \<comment> 	 \<customer>ground floor, non smoking\</customer> 	 \</comment> 	\</reservationdetails> \</lookupreservationresponse> response codes code description l1 unspecified error please contact customer support l2 user id not supplied or not valid l3 no xml input detected l4 erroneous or incomplete data in lookup reservation request l5 reservation number not provided l6 request ip address not found for the user l7 request ip address not matched for the user l8 reservation was not found l9 reservation does not belong to this user