Reservation Report
14 min
introduction the reservation report method allows users to check the status and details of one or more bookings limitations this method will return a maximum of 1000 records depending on a customer's typical booking volume, 1000 bookings may occur over the course of several days or several weeks please be mindful of this when inputting date range parameters request the reservation report request offers several ways to search allowing you to view your bookings how you like endpoint {{endpoint report}} true 0,151,0,52left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type date ranges the reservation report provides three date range search options the most common would be ‘reservation ’ you control the type of date search with the datesbasedon element and the following values reservation – the booking date for the reservation(s) arrival – the check in date for the reservation(s) departure – the check out date for the reservation(s) confirmation type and reservation status the confirmationtype and reservationstatus elements can be used together to generate several types of reports confirmationtype con confirmed reservations req on request reservations all both confirmed and on request reservations reservationstatus normal the reservation is live/active modified the reservation is live/active and has been modified cancelled the reservation is not live/active all all three status options above normal, modified, and cancelled example configurations view all bookings \<confirmationtype>all\</confirmationtype> \<reservationstatus>all\</reservationstatus> view confirmed bookings that are live \<confirmationtype>con\</confirmationtype> \<reservationstatus>normal\</reservationstatus> view all cancelled bookings \<confirmationtype>all\</confirmationtype> \<reservationstatus>cancelled\</reservationstatus> view all confirmed bookings that are modified \<confirmationtype>con\</confirmationtype> \<reservationstatus>modified\</reservationstatus> response elements that are not used will return closed for example, if the reservation has not been cancelled, the cancellationfee element will be closed \<cancellationfee/> true 132,151,85left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type code example request {{endpoint report}} the request below will return all bookings with all confirmation types and all reservation status’ that were booked between 01 jan 2024 and 02 jan 2024 \<?xml version="1 0" encoding="utf 8" ?> \<reservationreportrequest xmlns\ xsi="http //www w3 org/2001/xmlschema instance" timestamp="20180102t00 00 00"> 	\<control> 	 \<username>sampleuser\</username> 	 \<password>samplepass\</password> 	\</control> 	\<datesbasedon>reservation\</datesbasedon> 	\<startdate>01 jan 2024\</startdate> 	\<enddate>02 jan 2024\</enddate> 	\<confirmationtype>all\</confirmationtype> 	\<reservationstatus>all\</reservationstatus> \</reservationreportrequest> response expected response note that some of the data has been redacted in an actual response "###" would be replaced with valid values \<?xml version="1 0" encoding="utf 8" ?> \<reservationreportresponse status="y"> \<reservationlist> \<reservation> \<bookingnumber>###\</bookingnumber> \<touroperatorordernumber>\</touroperatorordernumber> \<hotelcode>###\</hotelcode> \<reservationstatus>normal\</reservationstatus> \<confirmationtype>con\</confirmationtype> \<reservationtimestamp>2024 06 21t16 18 11 848+0000\</reservationtimestamp> \<checkin>13 aug 2024\</checkin> \<noofrooms>1\</noofrooms> \<noofnights>1\</noofnights> \<total>300 00\</total> \</reservation> \<reservation> \<bookingnumber>###\</bookingnumber> \<touroperatorordernumber>\</touroperatorordernumber> \<hotelcode>###\</hotelcode> \<reservationstatus>cancel\</reservationstatus> \<confirmationtype>con\</confirmationtype> \<reservationtimestamp>2024 06 21t22 53 12 457+0000\</reservationtimestamp> \<checkin>24 sep 2024\</checkin> \<noofrooms>1\</noofrooms> \<noofnights>2\</noofnights> \<total>500 00\</total> \</reservation> \<reservation> \<bookingnumber>###\</bookingnumber> \<touroperatorordernumber>\</touroperatorordernumber> \<hotelcode>###\</hotelcode> \<reservationstatus>cancel\</reservationstatus> \<confirmationtype>con\</confirmationtype> \<reservationtimestamp>2024 06 21t21 47 21 898+0000\</reservationtimestamp> \<checkin>04 nov 2024\</checkin> \<noofrooms>1\</noofrooms> \<noofnights>3\</noofnights> \<total>0 00\</total> \</reservation> \</reservationlist> \</reservationreportresponse> error response if there is an error with your request and we are not able to return results, we will instead return the following xml where the status element is equal to ‘n’ and we include an error response code \<?xml version="1 0" encoding="utf 8" ?> \<reservationreportresponse status="n"> 	\<errors> 	 \<code>d7\</code> 	 \<description> reservation not found \</description> 	\</errors> \</reservationreportresponse> response codes true 78left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type