Skip to main content
An OTA Tour Activity Search Response message listing tour/excursion services for the requested area. It may include high‑level product metadata (ID, schedule, category, description, location, policies) and, where provided by the contract, indicative pricing.
SearchRS returns catalog data for services in scope. Use AvailRS for date/option‑level availability & final pricing.

​
Purpose

This message is used to:
  • Return the catalog of tour activities matching the requested location(s).
  • Provide service identifiers used later in Avail and Book flows.
  • Convey descriptions, categories, locations, and policies (cancellation, participant rules).
  • Optionally include expected/indicative rates for reference.

​
Structure – Root Element

<OTA_TourActivitySearchRS>
Key Attributes:
  • Version: OTA messaging pack version (e.g., 2016.b)
  • xmlns: http://www.opentravel.org/OTA/2003/05

​
Structure – Core Elements

​
TourActivityInfo

Repeating container of returned services.

​
BasicInfo

SpecifieS the service identifiers. 
<BasicInfo SupplierProductCode="TE0GV003" Name="Exclusive Visit to Las Salinas de Janubio" ShortName="Entrance (Guided visit - 3) - ticket only" TourActivityID="LESACE81AS" SupplierServiceCode="TIC"/>
  • SupplierProductCode: Specifies which product(unit) of a stock is being described.
  • Name: Full name of the tour.
  • ShortName: Name of the product.
  • TourActivityID: MTS activity code.
  • SupplierServiceCode: Type of service.

​
Schedule

Availability window for the service. 
<Schedule>
    <Summary Start="2026-07-17" End="2026-07-17"/>
</Schedule>

​
CategoryAndType

Indicates the excursoin type and category. Later in the avail request, these can be used to filter out responses. 
<CategoryAndType>
    <Category Code="XA"/>
    <Type Code="MM"/>
</CategoryAndType>

​
Description

Shows main NBC content of the product:
  • Short and long descriptions of the activity.
  • Multimedia with images of the activity. For more details, see MultimediaDescription.
  • TextItems describes different facts of the activity.
See Complete Examples.

​
Location

Location of the activity. Consists of:
  • Address.
  • Region hierarchy.
  • Position (geo codes).
<Location>
	<Address>
		<AddressLine>Centro Commercial Playa</AddressLine>
		<CityName>Puerto del Carmen</CityName>
		<PostalCode>35555</PostalCode>
		<Country>ES</Country>
		<StateProv>Lanzarote</StateProv>
	</Address>
	<Region RegionCode="Country">Spain</Region>
	<Region RegionCode="Destination">Canarian Islands</Region>
	<Region RegionCode="Region">Lanzarote</Region>
	<Region RegionCode="Resort">Puerto del Carmen</Region>
	<Region RegionCode="TravelDestination">ACE</Region>
	<Position Latitude="30.0" Longitude="-15.0"/>
</Location>

​
PickupDropoff

The response includes all the operation times, duration of the service and pickup times. The attribute PickupInd=“true” indicates if the location and date time corresponds to the pickup (true) or dropoff (false). 
<PickupDropoff LocationName="AESACE5UIO" PickupInd="true" DateTime="2026-07-17">
    <Schedule>
        <OperationTimes>
            <OperationTime Start="2026-07-17" End="2026-07-17"/>
        </OperationTimes>
    </Schedule>
</PickupDropoff>

​
Policies

May include:
  • CancelPolicy: Cancellation policy of the tour, similar structure as hotel cancel policies.
  • Participant: Participant rules.

​
Pricing

Returns the cheapest possible price for the tour and it’s type. 
<Pricing MinPrice="75.00" CurrencyCode="EUR">
    <PricingType>PerPerson</PricingType>
</Pricing>

​
Complete Examples

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<OTA_TourActivitySearchRS
    xmlns="http://www.opentravel.org/OTA/2003/05">
    <Success/>
    <TourActivityInfo>
        <BasicInfo SupplierProductCode="ST" Name="Music Show" ShortName="Standard Entrance - ticket only" TourActivityID="LESACE81AS" SupplierServiceCode="TIC"/>
        <Schedule>
            <Summary Start="2026-07-17T19:30:00" Duration="PT5H" End="2026-07-18T00:30:00"/>
        </Schedule>
        <CategoryAndType>
            <Category Code="XA"/>
            <Type Code="SE"/>
        </CategoryAndType>
        <Description>
            <ShortDescription>Music Show</ShortDescription>
            <LongDescription>This long-running comedy variety show has been entertaining audiences for years with its unique blend of humor, music, and theatrical flair.
Hosted in its original venue, the show features a talented cast performing lively dinner performances filled with laughter, music, and unforgettable parodies of iconic stars and films.
It's a night of fun for all ages, promising non-stop entertainment, catchy tunes, and hilarious sketches that keep the audience engaged from start to finish.
Even those who think this type of show isn’t for them often leave saying it was the highlight of their trip.
Tickets typically include a three-course meal along with keepsakes to remember the evening.</LongDescription>
            <Multimedia>
                <MultimediaDescription>
                    <TextItems>
                        <TextItem Category="EX_DIFFIC" SourceID="EX_DIF_1">
                            <Description>Easy</Description>
                        </TextItem>
                        <TextItem Category="EX_INCL" SourceID="EX_INCL_FOOD">
                            <Description>Meals</Description>
                        </TextItem>
                        <TextItem Category="EX_INCL" SourceID="EX_INCL_O">
                            <Description>Prices include a 3 course Dinner plus a Souvenir Photo &amp; Program.</Description>
                        </TextItem>
                        <TextItem Category="EX_INCL" SourceID="EX_INCL_VEGE">
                            <Description>Vegetarian Food</Description>
                        </TextItem>
                        <TextItem Category="EXCURSION" SourceID="EX_LANGSPOKEN">
                            <Description>English</Description>
                        </TextItem>
                        <TextItem Category="EX_NOTINCL" SourceID="EX_NOTINCL_DRINK">
                            <Description>Drinks</Description>
                        </TextItem>
                        <TextItem Category="EX_NOTINCL" SourceID="EX_NOTINCL_HPD">
                            <Description>Hotel pickup and drop-off (optional)</Description>
                        </TextItem>
                        <TextItem Category="EXCURSION" SourceID="EX_PVOUCHER">
                            <Description>Printed Voucher accepted</Description>
                        </TextItem>
                        <TextItem Category="EX_TARGET" SourceID="EX_TARGET_ALL">
                            <Description>Anybody</Description>
                        </TextItem>
                        <TextItem Category="EX_THEME" SourceID="EX_THEME_ENTERT">
                            <Description>Entertainment</Description>
                        </TextItem>
                        <TextItem Category="EX_HIGHL" SourceID="IS_DESC001">
                            <Description>Experience the funniest night out in the Canary Islands!
Fit for all ages!
</Description>
                        </TextItem>
                    </TextItems>
                </MultimediaDescription>
            </Multimedia>
        </Description>
        <Location>
            <Address>
                <AddressLine>Centro Commercial Playa</AddressLine>
                <CityName>Puerto del Carmen</CityName>
                <PostalCode>35555</PostalCode>
                <Country>ES</Country>
                <StateProv>Lanzarote</StateProv>
            </Address>
            <Region RegionCode="Country">Spain</Region>
            <Region RegionCode="Destination">Canarian Islands</Region>
            <Region RegionCode="Region">Lanzarote</Region>
            <Region RegionCode="Resort">Puerto del Carmen</Region>
            <Region RegionCode="TravelDestination">ACE</Region>
            <Position Latitude="30.0" Longitude="-15.0"/>
        </Location>
        <PickupDropoff LocationName="AMTSES08UI" PickupInd="true" OtherInfo="NEARESTBUSSTOP / NearestBusStop" DateTime="2026-07-17T18:55:00">
            <Schedule Duration="PT5H">
                <OperationTimes>
                    <OperationTime Start="2026-07-17" End="2026-07-18"/>
                </OperationTimes>
            </Schedule>
        </PickupDropoff>
        <Policies>
            <Participant MinParticipants="1" MaxParticipants="99"/>
        </Policies>
        <Pricing MinPrice="75.00" CurrencyCode="EUR">
            <PricingType>PerPerson</PricingType>
        </Pricing>
    </TourActivityInfo>
</OTA_TourActivitySearchRS>

​
Best Practices

  1. Expect empty lists when no services match the request; this is not an error.
  2. Treat any Pricing in SearchRS as reference only; fetch final pricing with AvailRS before quoting.
  3. Persist TourActivityID and any supplier codes for efficient follow‑up calls.
  4. Honor participant limits and cancellation rules surfaced in Policies when building UI constraints.