API Description: Create a list of tours based on the variable passed.

API URL: https://www.gotravelmanager.com/TravelManager/API/Tour/tourList.php?

(mandatory)   record={$companyid}&appid={$appid}&token={$token}
(optional)    offset={$offset}&num={$num}&order={$order_by}&start={$start_date}
(optional)    so={$so}&range={$range}&type={$type}
(optional)    updates={$updates}&timestamp={$timestamp}   //To get a list of tours which are updated since {$timestamp}
(optional)    end={$end}&keywords={$keywords}&duration={$duration}

Variables in the URL:
*  companyid : id of the tour operator

*  appid : unique application ID for your Travelmanager account

*  token : unique token for your TravelManager account

*  offset : Start point (can be used if you need to display tours on more than one page)

*  num : Max number of tours in the API response (again, can be used for multiple page purpose)

*  order_by : Sort the results according to {‘price’, ‘name’, ‘time’}, and ‘time’ is the default value
– price : price of the single ticket
– name: name of the tour
– time: tour start date and time

* start : ONLY shows the tours with start date equal or bigger than the value, and its format is date(“Ymd”), e.g. 20081202

* so : Set its value to 1 to indicate that you ONLY want to show special offers, and the default value is 0

* range : Tours start within $range number of days from $start.

* type: You can set its value to certain tour type to ONLY show the tours of type $type which can be but not limited to: {‘Events’, ‘Scenic’, ‘Family’, ‘Shopping’, ‘Day’, ‘Night’, ‘Wedding’, ‘Holiday’} . Also, see the following screenshot to find out where is the type come from inside TM.

* updates: Set its value to 1 if you only want to get a list of tours which have been updated since {$timestamp} //Added on17/07/2009

* timestamp: It works tegether with {$updates} in order to get a list tours with updates, and its format is date(“YmdHis”), e.g. 20090620120000 //Added on17/07/2009

* keywords: tour name, description and highlights

* duration: {’1′, ‘more’}. 1: only show single day tours; more: only show multiple-day tours

HTTP Method: GET

Example – Response Code 701 (Authentication Failed)

<?xml version=”1.0″ encoding=”UTF-8″?>
<rsp stat=”invalid” code=”701″ created-at=”2009-06-26T09:41:14+01:00″>
<errorMessage>Authentication Failed</errorMessage>
</rsp>

Example – Response Code 703 (Tour Not Found)

<?xml version=”1.0″ encoding=”UTF-8″?>
<rsp stat=”invalid” code=”703″ created-at=”2009-06-26T09:38:42+01:00″>
<errorMessage>Tour Not Found</errorMessage>
</rsp>

Example – Response Code 700 (Successful)

<?xml version=”1.0″ encoding=”UTF-8″?>
<rsp stat=”valid” code=”700″ created-at=”2009-06-26T12:56:50+01:00″>
<tour>
<id>1090</id> /* ID of the tour */
<name>Blackpool Day Trip</name>
<duration>1</duration>
<overview>&lt;p&gt;Fun Fair…&lt;/p&gt;</overview>
<startDate>2009-06-30</startDate>
<startTime>06:00:00</startTime>
<currency>$</currency>
<priceSingle>100</priceSingle>
<priceDouble>100</priceDouble>
<priceTriple>100</priceTriple>
<priceQuad>100</priceQuad>
<imageUrl></imageUrl>
<imageName></imageName>
<imageDescription></imageDescription>
</tour>
<tour>
<id>1088</id>
<name>PARIS DAY TRIP</name>
<duration>1</duration>
<overview>&lt;p&gt;&lt;strong&gt;This is a &lt;em&gt;good &lt;/em&gt;Tour&lt;/strong&gt;&lt;/p&gt;</overview>
<startDate>2009-04-30</startDate>
<startTime>06:00:00</startTime>
<currency>$</currency>
<priceSingle>260</priceSingle>
<priceDouble>220</priceDouble>
<priceTriple>240</priceTriple>
<priceQuad>190</priceQuad>
<imageUrl>http://s3.amazonaws.com/tmDms/OWFpbWFnZXMuanBn</imageUrl>
<imageName>Paris Tour 1</imageName>
<imageDescription>this is the first image</imageDescription>
</tour>
</rsp>