Skip to main content
The OTA_TourActivityAvailRS (Tour & Activity Availability Response) returns available excursion services and pricing, corresponding to the search parameters sent in OTA_TourActivityAvailRQ. A <Success/> element indicates the request was processed; otherwise errors are returned. Results may be aggregated as one price-from per service (MF002) or expanded per product/subservice (MF001).

Structure – Root Element

<OTA_TourActivityAvailRS>
Key Attributes:
  • xmlns: http://www.opentravel.org/OTA/2003/05.
  • Version: 2016.b (OTA Tour Activity messaging pack).
  • TransactionIdentifier: Correlates the transaction across systems (optional).

Structure – Core Elements

TourActivityInfo

Container for one available service result.

BasicInfo

Service identification and labeling for the product/subservice.
  • 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.
<BasicInfo SupplierProductCode="FK000000" Name="Fuerteventura Leisure" ShortName="Ferry Ticket - ticket only" TourActivityID="LESACE81AS" SupplierServiceCode="TIC"/>

Schedule

Availability summary for the specific departure/slot.
  • Summary/@Start: Start datetime (ISO 8601).
  • Summary/@End: End datetime (ISO 8601).
  • Summary/@Duration: ISO 8601 duration (e.g., PT8H).
<Schedule>
    <Summary Start="2026-07-17T09:30:00" Duration="PT8H" End="2026-07-17T17:30:00"/>
</Schedule>

CategoryAndType

Classification of the service.
  • Category/@Code: Category (e.g., Excursion vs Ticket).
  • Type/@Code: Activity type code (implementation-defined).
<CategoryAndType>
    <Category Code="XA"/>
    <Type Code="BT"/>
</CategoryAndType>

Description

Short text describing the service.
  • ShortDescription
<Description>
    <ShortDescription>Fuerteventura Leisure</ShortDescription>
</Description>

Location

Where the service operates; includes postal address, regions, and geo position.
  • Address: AddressLine, CityName, PostalCode, Country, StateProv.
  • Region: @RegionCode values such as Country, Destination, Region, Resort, TravelDestination.
  • Position: @Latitude, @Longitude.
<Location>
    <Address>
    <AddressLine>Corralejo</AddressLine>
    <CityName>Playa Blanca</CityName>
    <PostalCode>35660</PostalCode>
    <Country>ES</Country>
    <StateProv>Lanzarote</StateProv>
    </Address>
    <Region RegionCode="Country">ES</Region>
    <Region RegionCode="Destination">Canarian Islands</Region>
    <Region RegionCode="Region">Lanzarote</Region>
    <Region RegionCode="Resort">Playa Blanca</Region>
    <Region RegionCode="TravelDestination">ACE</Region>
    <Position Latitude="28.86275" Longitude="-13.82973"/>
</Location>

Pricing

Price container. Returned format depends on MF mode:
  • MF002 (price-from per service)Summary/@MinCharge with CurrencyCode; PricingType = PerPerson.
  • MF001 (detailed per product/subservice)Summary/@Amount with CurrencyCode; PricingType = PerGroup.
<Pricing>
    <Summary MinCharge="40.00" CurrencyCode="EUR">
    <PricingType>PerPerson</PricingType>
    </Summary>
</Pricing>

PickupDropoff (MF001 results with transfer service)

Operational pickup/dropoff information and indicators.
  • @PickupInd: true for pickup records; false for dropoff.
  • @DateTime: Pickup/dropoff local datetime.
  • @LocationName, @Code, @MeetingLocation: Operational details (as provided).

Complete Examples

<OTA_TourActivityAvailRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="2016.b" TransactionIdentifier="1-2/2">
  <Success/>
  <TourActivityInfo>
    <BasicInfo SupplierProductCode="FK000000" Name="Fuerteventura Leisure" ShortName="Ferry Ticket - ticket only" TourActivityID="LESACE81AS" SupplierServiceCode="TIC"/>
    <Schedule>
      <Summary Start="2026-07-17T09:30:00" Duration="PT8H" End="2026-07-17T17:30:00"/>
    </Schedule>
    <CategoryAndType>
      <Category Code="XA"/>
      <Type Code="BT"/>
    </CategoryAndType>
    <Description>
      <ShortDescription>Fuerteventura Leisure</ShortDescription>
    </Description>
    <Location>
      <Address>
        <AddressLine>Corralejo</AddressLine>
        <CityName>Playa Blanca</CityName>
        <PostalCode>35660</PostalCode>
        <Country>ES</Country>
        <StateProv>Lanzarote</StateProv>
      </Address>
      <Region RegionCode="Country">ES</Region>
      <Region RegionCode="Destination">Canarian Islands</Region>
      <Region RegionCode="Region">Lanzarote</Region>
      <Region RegionCode="Resort">Playa Blanca</Region>
      <Region RegionCode="TravelDestination">ACE</Region>
      <Position Latitude="25.86275" Longitude="-15.82973"/>
    </Location>
    <Pricing>
      <Summary MinCharge="40.00" CurrencyCode="EUR">
        <PricingType>PerPerson</PricingType>
      </Summary>
    </Pricing>
  </TourActivityInfo>
</OTA_TourActivityAvailRS>

Notes & Constraints

  • MF modes: MF002 returns a single price-from (per person) per service; MF001 returns detailed products/subservices priced per group with operational details like pickups.
  • Pickup/dropoff in Ticket-only services: Not included when the service is a pure ticket (no transfer).
  • Region usage: When regions are provided, Country is required; other levels (Destination/Region/Resort/TravelDestination) are optional as applicable.