home > support > API > Marketplace API > API: tour/hotel information

Show Tour

Purpose	Return full information about a specific Tour/Hotel
Notes	N/A
REST info	Call	/c/tour/show
	Formats	XML
	Example	/c/tour/show.xml?id=92
	Verb	GET
Code	PHP C# VB PHP examples use the PHP Client Library with SimpleXML Description `object show_tour( int $tour, int $channel )` Parameters `$tour ID for the Tour $channel ID for the Channel (Operator) - required as Tour IDs are not unique` Example `// ID for the Tour/Hotel we want the details for $tour = 152; // Channel (Operator) ID of the Tour/Hotel $channel = 6; // Query the TourCMS API $result = $tourcms->show_tour($tour, $channel); // Go straight to the tour node $tour = $result->tour; // Print out the tour name and lead in price print $tour->tour_name.' - from only '.$tour->from_price_display;` `Nile Family Adventure - from only £650` C# examples use the .Net Client Library Overload list `XmlDocument ShowTour (int tourId, int ChannelId)` Parameters `tourId ID for the Tour ChannelId ID for the Channel (Operator) - required as Tour IDs are not unique` Example `// ID for the Tour/Hotel we want the details for int tourId = 152; // Channel (Operator) ID of the Tour/Hotel int channelId = 6; // Query the TourCMS API XmlDocument doc = myTourCMS.ShowTour(tourId, channeId); // Display the tour name and lead in price string tourName = doc.SelectSingleNode("//tour/tour_name").innerText; string tourPrice = doc.SelectSingleNode("//tour/from_price_display").innerText; Console.WriteLine(tourName + " - from only " + tourPrice);` `Nile Family Adventure - from only £650` VB examples use the .Net Client Library Overload list `XmlDocument ShowTour (int tourId, int ChannelId)` Parameters `tourId ID for the Tour ChannelId ID for the Channel (Operator) - required as Tour IDs are not unique` Example `' ID for the Tour/Hotel we want the details for Dim tourId As Integer = 152 ' Channel (Operator) ID of the Tour/Hotel Dim channelId As Integer = 6 ' Query the TourCMS API Dim doc As XmlDocument = myTourCMS.ShowTour(tourId, channeId) ' Display the tour name and lead in price Dim tourName As String = doc.SelectSingleNode("//tour/tour_name").innerText Dim tourPrice As String = doc.SelectSingleNode("//tour/from_price_display").innerText Console.WriteLine(tourName & " - from only " & tourPrice)` `Nile Family Adventure - from only £650`

Querystring parameters

Querystring parameters
Parameter	Notes
id	Tour ID

The Channel ID is also passed via the request header, this is required as Tour IDs are unique within a particular channel (Operator) rather than being unique system wide.

Response fields

Node

Notes

request

Confirmation of the request that you sent

error

Any error message returned, if there is no error this will just contain the text OK

tour

The tour node contains the following child nodes.

Node

Notes

channel_id

Channel ID

account_id

Account ID

tour_id

Tour/Hotel ID

tour_name

Tour/Hotel name

start_time

Start time / Opening time for the Tour/Hotel.

May be a 24 hour time value in local time (e.g. "09:00").

If there are multiple start times per day or the start time varies by day then the value will be "MULTI".

Alternatively if start time is unknown / irrelevent then this field may be blank (although the start time may be explained elsewhere in the Tour/Hotel description, e.g. in the pickup points section).

end_time

End time / Closing time for the Tour/Hotel.

Possible values as per start_time above.

has_sale

1 - Future product on sale
0 - No future product on sale

has_d

1 - Has a tour departure loaded
0 - No tour departure loaded

has_f

1 - Has a tour freesale loaded
0 - No tour freesale loaded

has_h

1 - Has a hotel product type loaded
0 - No hotel product type loaded

descriptions_last_updated

When the tour/hotel text descriptions were last updated, date format YYYY-MM-DD

next_bookable_date

First date the tour/hotel text is bookable, date format YYYY-MM-DD

has_sale_jan
has_sale_feb
has_sale_mar
has_sale_apr
has_sale_may
has_sale_jun
has_sale_jul
has_sale_aug
has_sale_sep
has_sale_oct
has_sale_nov
has_sale_dec

1 - Future product on sale (by the month)
0 - No future product on sale (by the month

quantity_rule

1 - price x 1
q - price x quantity

tour_code

Tour code (only returned if set)

from_price

Lead in price

from_price_display

Lead in price - display version (Includes HTML entity currency code and no decimals)

from_price_jan
from_price_feb
from_price_mar
from_price_apr
from_price_may
from_price_jun
from_price_jul
from_price_aug
from_price_sep
from_price_oct
from_price_nov
from_price_dec

Lead in price by the month
Use to create a nice seasonal price chart

There are also _display versions that work the same way as from_price_display

sale_currency

Sale currency (for the lead in price). Currency is set by channel

priority

HIGH, MEDIUM, LOW - Commercial priority

address

Postal address

geocode_start

Lat,Long geocode for start point

geocode_end

Lat,Long geocode for end point

grade

1 - All ages / Not applicable
2 - Moderate
3 - Fit
4 - Challenging
5 - Extreme

accomrating

1 - No accommodation / Not applicable
2 - Luxury
3 - Moderate
4 - Comfortable
5 - Basic
6 - Various levels

product_type

1 - Accommodation (hotel/campsite/villa/ski chalet/lodge)
2 - Transport
3 - Tour/cruise including overnight stay
4 - Day tour/trip/activity/attraction (No overnight stay)
5 - Tailor made
6 - Event
7 - Training/education
8 - Other

tourleader_type

1 - Tour guide / driver
2 - Independent / self drive
3 - Not applicable (e.g. accommodation / event)

location

Primary location - Perhaps a city name, national park name or region

summary

Summary - Includes primary activity if not clear from tour/hotel name

country

Comma separated list of uppercase countries the tour takes place in

duration_desc

Text description for duration (e.g. 1 week)

duration

Duration (Days)

available

Text description for when available (e.g. March to September)

shortdesc

Short description (NO HTML)

longdesc

Long description

itinerary

Itinerary

exp

Rather than facts, this description should focus on the experience e.g. a wonderful hill walk with great vistas

pick

Pickup / Dropoff information

inc_ex

Included / Excluded

essential

Essential information - What to bring, accommodation details, single supplements, solo travellers

extras

Extras / upgrades

rest

Restrictions - e.g. Pets, minimum age / children permitted, whether requires a preexisting skill etc

tour_url

URL for the tour detail page

tour_url_tracked

URL for the tour detail page - via agent tracking mechanism
Not returned for /c/tours/search

book_url

URL to booking engine / live availability display (can be iframed onto your site)

supplier_id

If a Tour Operator is using the API call directly then supplier_id will contain the internal reference number for the supplier on the main Tour/Hotel on the booking. Not returned when a Marketplace Partner is using the API.

images

The images node will contain between 1 and 6 image nodes.

Node

Notes

image

The first image node will contain a thumbnail attribute with the value true, this image should be used as the thumbnail if a single image is being displayed (e.g. list pages).

Each image node contains a url node and image_desc node.

Node	Notes
url	URL (web address) for the image
image_desc	Description / caption for image

new_booking

Information to help those building their own booking engine using the API. Includes data that might be useful if designing a booking form:

Node

Notes

people_selection

Information on the various rates (pricing tiers) offered, including min/max numbers of people

Node

Notes

rate

There will be a rate node for each individual pricing tier offered on this Tour/Hotel containing:

Node	Notes
label_1	Main customer facing descriptor for this rate, e.g. "Adults". May be blank in which case display text such as "Number of people"
label_2	Secondary customer facing descriptor for this rate, e.g. "(16plus)"
minimum	Minimum number of people per booking on this rate
maximum	Maximum number of people per booking on this rate
rate_id	Identifier for the rate

date_selection

Information on how dates & durations are calculated for this Tour/Hotel, useful for determining how to present date / duration selection.

Node	Notes
date_type	- DATE Tour type availability - DATE_DAYS Hotel type availability, duration in days - DATE_NIGHTS Hotel type availability, duration in days
duration_minimum	The minimum duration that must be booked for this Tour/Hotel. Only shows if date_type is either DATE_DAYS or DATE_NIGHTS.
duration_minimum	The maximum duration that must be booked for this Tour/Hotel. Only shows if date_type is either DATE_DAYS or DATE_NIGHTS.

Sample XML Response

/c/tour/show.xml?id=92

<?xml version="1.0" encoding="utf-8"?>
<response>
    <request>GET /c/tour/show.xml?id=92</request>
    <error>OK</error>
    <tour>
        <channel_id>6</channel_id>
        <account_id>5</account_id>
        <tour_id>92</tour_id>
        <tour_name>Egypt &amp; Jordan Adventure</tour_name>
        <tour_code>CUEGGJ</tour_code>
        <quantity_rule>Q</quantity_rule>
        <from_price>1110.00</from_price>
        <from_price_display>&amp;#163;1110</from_price_display>
        <sale_currency>GBP</sale_currency>
        <has_sale>1</has_sale>
        <has_d>1</has_d>
        <has_f>1</has_f>
        <has_h>0</has_h>
        <descriptions_last_updated>2011-01-01</descriptions_last_updated>
        <next_bookable_date>2012-02-15</next_bookable_date>
        <has_sale_jan>1</has_sale_jan>
        <has_sale_feb>1</has_sale_feb>
        <has_sale_mar>1</has_sale_mar>
        <has_sale_apr>1</has_sale_apr>
        <has_sale_may>1</has_sale_may>
        <has_sale_jun>1</has_sale_jun>
        <has_sale_jul>1</has_sale_jul>
        <has_sale_aug>1</has_sale_aug>
        <has_sale_sep>1</has_sale_sep>
        <has_sale_oct>1</has_sale_oct>
        <has_sale_nov>1</has_sale_nov>
        <has_sale_dec>1</has_sale_dec>
        <from_price_jan>1470.00</from_price_jan>
        <from_price_jan_display>&amp;#163;1470</from_price_jan_display>
        <from_price_feb>1195.00</from_price_feb>
        <from_price_feb_display>&amp;#163;1195</from_price_feb_display>
        <from_price_mar>1195.00</from_price_mar>
        <from_price_mar_display>&amp;#163;1195</from_price_mar_display>
        <from_price_apr>1195.00</from_price_apr>
        <from_price_apr_display>&amp;#163;1195</from_price_apr_display>
        <from_price_may>1160.00</from_price_may>
        <from_price_may_display>&amp;#163;1160</from_price_may_display>
        <from_price_jun>1110.00</from_price_jun>
        <from_price_jun_display>&amp;#163;1110</from_price_jun_display>
        <from_price_jul>1160.00</from_price_jul>
        <from_price_jul_display>&amp;#163;1160</from_price_jul_display>
        <from_price_aug>1160.00</from_price_aug>
        <from_price_aug_display>&amp;#163;1160</from_price_aug_display>
        <from_price_sep>1160.00</from_price_sep>
        <from_price_sep_display>&amp;#163;1160</from_price_sep_display>
        <from_price_oct>1295.00</from_price_oct>
        <from_price_oct_display>&amp;#163;1295</from_price_oct_display>
        <from_price_nov>1295.00</from_price_nov>
        <from_price_nov_display>&amp;#163;1295</from_price_nov_display>
        <from_price_dec>1295.00</from_price_dec>
        <from_price_dec_display>&amp;#163;1295</from_price_dec_display>
        <priority>HIGH</priority>
        <country>EG,JO</country>
        <geocode_start>30.042944,31.25885</geocode_start>
        <geocode_end>31.940509,35.933533</geocode_end>
        <product_type>3</product_type>
        <tourleader_type>1</tourleader_type>
        <grade>1</grade>
        <accomrating>3</accomrating>
        <location>Nile Valley, Red Sea &amp; Jordan</location>
        <summary>Two weeks covering the Pyramids, Nile Valley, a felucca/luxury cruise, Red Sea snorkelling, and time at Wadi Rum, Petra and the Dead Sea in Jordan</summary>
        <shortdesc>This 16-day tour begins in Cairo, visiting the Pyramids, Sphinx and Saqqara and featuring an optional city &amp; museum tour. From here we take the overnight train to Aswan before beginning our journey towards Luxor by Felucca sailboat. We will then transfer back to Cairo for one night and then head to the Red Sea at Dahab for a short stay after which we cross into Jordan to visit Petra, Jerash, the Dead Sea, and many other sites</shortdesc>
        <longdesc>Day 1 - Arrive in Cairo. We will meet you at the airport and assist you in obtaining your Egyptian visa. We then transfer to your Cairo hotel.
        
        Day 2 - After a morning pre-tour meeting by your group guide we take you on a full day tour to the Pyramids &amp; Sphinx at Gisa before visiting the Egyptian Museum in Cairo to see the famous Tutankhamun exhibit. Your guide will be a fully trained local Egyptologist. In the evening we board the overnight sleeper train to Aswan.
        
        Day 3- We arrive in Aswan in the morning and transfer to your hotel. In the afternoon we take a tour to Philae Temple and the High Dam at Lake Nasser. The Philae Temple is dedicated to Isis and is situated on an island in Lake Nasser which was reclaimed from it's rising waters. 
        
        Day 4 - This morning, we offer the chance to head into the desert and tour the impressive temples of Abu Simbel, built by Ramses the Great. Today we will also take trips to visit the Nile Islands, before beginning our 2 night felucca cruise. We sleep on board the boat tonight (a luxury cruise upgrade is available if required).
        
        Day 5 - After breakfast on the boat, we sail peacefully up the Nile, before mooring near to the temple of Komombo. Tonight you will be entertained by the crew.
        
        Day 6 - We leave the boat this morning to begin our action packed day featuring trips to Komombo, which is dedicated to the Gods Sobek and Haroeris. Edfu, dedicated to the God Horus and finally we arrive at Luxor where we will visit the Karnak and Luxor Temples.
        
        Day 7 - We cross the Nile today to visit the sites on the west bank. These include the Valleys of the Kings &amp; Queens, with their pharaonic tombs; Hatchepsut temple, a testament to Egypt's only female Pharaoh, and the imposing Colossi of Memnom. We can also arrange for you to enjoy an early morning hot air balloon ride over the Nile today if you wish. Late in the evening we board the overnight sleeper train back to Cairo.
        
        Day 8 - This morning we will arrive in Cairo. After checking in to your hotel, the rest of the day is free. We offer a full day trip to Alexandria or to Wadi Rayan and the Valley of the Whales. You will spend the night in Cairo, why not sample one of Cairoâ��s many restaurants.
        
        Day 9 - We leave Cairo this morning by private vehicle and cross the Suez Canal into the Sinai peninsular to your Red Sea beach resort in Dahab. There is an option available to climb Mt Sinai this evening to see the incredible sunrise in the morning over this impressive landscape, followed by a visit to St. Katherine's monastery at the foot of the mountain. 
        
        Day 10 - Your day is free in Dahab today to relax after your last week's sightseeing. You can try some snorkelling or scuba-diving if you wish, or take a jeep or camel safari into the desert. 
        
        Day 11 - We have an early start this morning to catch the ferry to Jordan. We then head into the Jordanian desert and the spectacular scenery of Wadi Rum where we enjoy a Bedouin lunch and an afternoon jeep safari. The day finishes with a drive to our desert camp where we spend the night. We can also arrange for you to take a camel ride in the desert if you wish. 
        
        Day 12 - We take you on a fully guided tour of the sites in Petra today, including the Treasury, the Roman amphitheatre and the carved monuments. You then have free time later in the day to explore the city on your own.
         
        Day 13 - We visit 'Little Petra' this morning and then in the afternoon you have another chance to explore the main site if you wish. 
        
        Day 14 - This morning we follow the Kingâ��s Highway to Kerak â�� an old crusader town which lies on the ancient Egyptian/Syrian caravan route. We then travel via Madaba to Mt Nebo â�� a memorial site for Moses, before making the short drive into Amman. 
        
        Day 15 - We have 2 visits today, the first is to the ancient Roman ruins at Jerash, the second is to the Dead Sea, the lowest place on earth. Here you â��floatâ�� in the salty waters. We return to Amman this afternoon so why not visit the towns many bazaars.
        
        Day 16 - After breakfast your tour comes to an end, you have the day free until we transfer you to the airport for your return flight.</longdesc>
        <itinerary>Day 1 - Arrive in Cairo. We will meet you at the airport and assist you in obtaining your Egyptian visa. We then transfer to your Cairo hotel.
        
        Day 2 - After a morning pre-tour meeting by your group guide we take you on a full day tour to the Pyramids &amp; Sphinx at Gisa before visiting the Egyptian Museum in Cairo to see the famous Tutankhamun exhibit. Your guide will be a fully trained local Egyptologist. In the evening we board the overnight sleeper train to Aswan.
        
        Day 3- We arrive in Aswan in the morning and transfer to your hotel. In the afternoon we take a tour to Philae Temple and the High Dam at Lake Nasser. The Philae Temple is dedicated to Isis and is situated on an island in Lake Nasser which was reclaimed from it's rising waters. 
        
        Day 4 - This morning, we offer the chance to head into the desert and tour the impressive temples of Abu Simbel, built by Ramses the Great. Today we will also take trips to visit the Nile Islands, before beginning our 2 night felucca cruise. We sleep on board the boat tonight (a luxury cruise upgrade is available if required).
        
        Day 5 - After breakfast on the boat, we sail peacefully up the Nile, before mooring near to the temple of Komombo. Tonight you will be entertained by the crew.
        
        Day 6 - We leave the boat this morning to begin our action packed day featuring trips to Komombo, which is dedicated to the Gods Sobek and Haroeris. Edfu, dedicated to the God Horus and finally we arrive at Luxor where we will visit the Karnak and Luxor Temples.
        
        Day 7 - We cross the Nile today to visit the sites on the west bank. These include the Valleys of the Kings &amp; Queens, with their pharaonic tombs; Hatchepsut temple, a testament to Egypt's only female Pharaoh, and the imposing Colossi of Memnom. We can also arrange for you to enjoy an early morning hot air balloon ride over the Nile today if you wish. Late in the evening we board the overnight sleeper train back to Cairo.
        
        Day 8 - This morning we will arrive in Cairo. After checking in to your hotel, the rest of the day is free. We offer a full day trip to Alexandria or to Wadi Rayan and the Valley of the Whales. You will spend the night in Cairo, why not sample one of Cairoâ��s many restaurants.
        
        Day 9 - We leave Cairo this morning by private vehicle and cross the Suez Canal into the Sinai peninsular to your Red Sea beach resort in Dahab. There is an option available to climb Mt Sinai this evening to see the incredible sunrise in the morning over this impressive landscape, followed by a visit to St. Katherine's monastery at the foot of the mountain. 
        
        Day 10 - Your day is free in Dahab today to relax after your last week's sightseeing. You can try some snorkelling or scuba-diving if you wish, or take a jeep or camel safari into the desert. 
        
        Day 11 - We have an early start this morning to catch the ferry to Jordan. We then head into the Jordanian desert and the spectacular scenery of Wadi Rum where we enjoy a Bedouin lunch and an afternoon jeep safari. The day finishes with a drive to our desert camp where we spend the night. We can also arrange for you to take a camel ride in the desert if you wish. 
        
        Day 12 - We take you on a fully guided tour of the sites in Petra today, including the Treasury, the Roman amphitheatre and the carved monuments. You then have free time later in the day to explore the city on your own.
         
        Day 13 - We visit 'Little Petra' this morning and then in the afternoon you have another chance to explore the main site if you wish. 
        
        Day 14 - This morning we follow the Kingâ��s Highway to Kerak â�� an old crusader town which lies on the ancient Egyptian/Syrian caravan route. We then travel via Madaba to Mt Nebo â�� a memorial site for Moses, before making the short drive into Amman. 
        
        Day 15 - We have 2 visits today, the first is to the ancient Roman ruins at Jerash, the second is to the Dead Sea, the lowest place on earth. Here you â��floatâ�� in the salty waters. We return to Amman this afternoon so why not visit the towns many bazaars.
        
        Day 16 - After breakfast your tour comes to an end, you have the day free until we transfer you to the airport for your return flight.</itinerary>
        <duration_desc>16 days</duration_desc>
        <duration>18</duration>
        <available>All year round. Small-group departures approx. every other Saturday</available>
        <pick>A 24-hour airport meet &amp; greet and transfer service is included at the start and end of the tour</pick>
        <tour_url>http://www.egypt-uncovered.com/tours/egypt/geja.php</tour_url>
        <tour_url_tracked>http://live.tourcms.com/track/t.php?p=46&amp;m=0&amp;a=5&amp;k=2a552a58db22&amp;url=http%3A%2F%2Fwww.egypt-uncovered.com%2Ftours%2Fegypt%2Fgeja.php</tour_url_tracked>
        <book_url>https://live.tourcms.com/reserve/r1.php?t=92&amp;a=5&amp;w=6&amp;people=1&amp;ty=t&amp;k=50f5cfc4a17a&amp;agent=46&amp;m=1&amp;mh=bbbe61</book_url>
        <images>
            <image thumbnail="true">
                <url>http://media.tourcms.com/a/5/92/1.jpg</url>
                <image_desc>Egypt Uncovered group, The Pyramids, Gisa, Egypt</image_desc>
            </image>
            <image>
                <url>http://media.tourcms.com/a/5/92/2.jpg</url>
                <image_desc>Natural rock bridge, Wadi Rum, Jordan</image_desc>
            </image>
            <image>
                <url>http://media.tourcms.com/a/5/92/3.jpg</url>
                <image_desc>Statue at Karnak Temple, Egypt</image_desc>
            </image>
            <image>
                <url>http://media.tourcms.com/a/5/92/4.jpg</url>
                <image_desc>The Treasury, Petra, Jordan</image_desc>
            </image>
            <image>
                <url>http://media.tourcms.com/a/5/92/5.jpg</url>
                <image_desc>Felucca on the Nile, Egypt</image_desc>
            </image>
            <image>
                <url>http://media.tourcms.com/a/5/92/6.jpg</url>
                <image_desc>Colonnaded street, Jerash, Jordan</image_desc>
            </image>
        </images>
        <new_booking>
            <people_selection>
                <rate>
                    <label_1/>
                    <label_2/>
                    <minimum>1</minimum>
                    <maximum>30</maximum>
                    <rate_id>r1</rate_id>
                </rate>
            </people_selection>
            <date_selection>
                <date_type>DATE</date_type>
            </date_selection>
        </new_booking>
    </tour>
</response>

More information

Back to API list

Show Tour

Description

Parameters

Example

Overload list

Parameters

Example

Overload list

Parameters

Example

Querystring parameters

Response fields

Sample XML Response

More information