Skip to main content
Static, non-bookable content used for hotel mapping (rooms, boards, amenities, geo, media). Pairs with OTA_HotelDescriptiveInfoRQ.

Purpose

This response delivers Non‑Bookable Content (NBC) for one or multiple properties so partners can map hotels, rooms, boards, amenities, locations, images, and DRV/third‑party codes. It is optimized for periodic full loads and daily deltas.

Structure – Root Element

<OTA_HotelDescriptiveInfoRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="2009.1" TransactionIdentifier="1-37/37">
  ...
</OTA_HotelDescriptiveInfoRS>
Key Attributes
  • Version — specification version (e.g., 2009.1).
  • TransactionIdentifier — reports the count/range of hotels included in the payload.

Structure – Core Elements

HotelDescriptiveContent

Container and item for each property returned.
<HotelDescriptiveContent LanguageCode="EN" RPH="1" HotelCode="AMTSES08UI" HotelName="Hostal Cuba" HotelCodeContext="354402" LastModifiedDate="2024-06-30T04:07:59">
Common Attributes on HotelDescriptiveContent:
  • LanguageCode — ISO language code of the content.
  • RPH — sequence reference.
  • HotelCode — partner hotel code.
  • HotelName — marketing name.
  • HotelCodeContext — GIATA code when licensed.
  • ChainName (optional) — brand/chain.
  • LastModifiedDate — last modification timestamp for the property’s static data.

HotelInfo

High‑level static details. CategoryCodesHotelCategory and repeated GuestRoomInfo (room master data).
<CategoryCodes>
    <HotelCategory Code="20" CodeDetail="Hotel"/>
    <GuestRoomInfo Code="42" CodeDetail="RMSD000000">
    <DescriptiveText>Double Standard Room</DescriptiveText>
    </GuestRoomInfo>
    ...
</CategoryCodes>
Check Hotel Related Codes. DescriptionsDescriptiveText consists of a long‑form factsheet text; may contain multiple paragraphs.
<Descriptions>
    <DescriptiveText>
General Description
Located approximately 15 km from the nearest sandy beach, this charming rural hotel is set in a beautifully restored traditional farmhouse in the heart of Lanzarote. This boutique property offers a peaceful and authentic Canarian experience, surrounded by volcanic landscapes and vineyards. The town of San Bartolomé is just 2 km away, while Arrecife and Teguise are within a 10-minute drive. Guests will find a supermarket only 150 m from the property, and popular attractions such as Timanfaya National Park (18 km) and the Wine Museum (3 km) are easily accessible. Lanzarote Airport (ACE) is conveniently located just 5 km away, and the nearest hospital is 8 km from the hotel.

Amenities
This two-storey boutique hotel features 8 individually decorated rooms that combine rustic charm with modern comfort. Guests are welcomed at a cozy reception area (check-in from 12:00, check-out until 12:00), and free private parking is available on site. The hotel offers complimentary Wi-Fi throughout the property. Additional services include laundry and ironing (available for a fee). The on-site restaurant serves locally inspired cuisine in a warm and intimate setting, using fresh, seasonal ingredients.

Meals
Guests can enjoy a daily breakfast buffet featuring local products. Half-board options include breakfast and a delicious à la carte dinner served at the hotel’s restaurant.

Sport and Leisure
While the hotel is designed for relaxation, guests can enjoy a variety of nearby activities. Tennis courts are located approximately 15 km away, and water sports such as windsurfing, diving, and sailing are available at nearby beaches (services provided by local operators). A golf course is located around 12 km from the hotel. The surrounding area is ideal for hiking, cycling, and wine tasting tours.

Additional Information
Please note that some services and amenities may incur additional charges or depend on seasonal availability. The hotel staff speaks English, German, </DescriptiveText>
</Descriptions>
Position (Latitude, Longitude) — geo coordinates placed under HotelInfo.
<Position Latitude="29.04025" Longitude="-13.51425"/>
Services → repeated Service entries; each Service may include Features/Feature and OperationSchedules.
<Services>
    <Service ID="BB" CodeDetail="Board">
    <DescriptiveText>Breakfast</DescriptiveText>
    </Service>
    <Service CodeDetail="FOOD|DININGROOM|FB_AIRCOND|">
    <DescriptiveText>Food &amp; Beverage|Dining Room|Air-Conditioning|</DescriptiveText>
    </Service>
    ...
</Services>
Service@CodeDetail encodes a hierarchy using line breaks (pipes in textual examples). Related values can appear under Features/Feature@CodeDetail with a DescriptiveText value. Duration windows may be modeled with OperationSchedules/OperationSchedule.

AreaInfo

Location taxonomy and airports. Airports may specify:
  • Nearest (boolean), PrimaryIndicator (main airport),
  • Distance (km) with UnitOfMeasureCode="2", and Proximity (travel time in minutes).
<AreaInfo>
    <RefPoints>
        <RefPoint Name="Spain" RefPointName="Country"/>
        <RefPoint Name="San Bartolome" RefPointName="Resort"/>
        <RefPoint Name="Lanzarote" RefPointName="Region"/>
        <RefPoint Name="ES" RefPointName="CountryCode"/>
        <RefPoint Nearest="true" Name="ACE" PrimaryIndicator="true" Distance="5" UnitOfMeasureCode="2" Proximity="15" RefPointName="Airport"/>
    </RefPoints>
</AreaInfo>

AffiliationInfo

Optional star rating via Award@Rating (e.g., 4 Stars).
<AffiliationInfo>
    <Awards>
        <Award Rating="2 Stars"/>
    </Awards>
</AffiliationInfo>

MultimediaDescriptions

Image catalog per property.
  • ImageItem (category via Category/ID) and optional LastModifyDateTime.
  • ImageFormat includes DimensionCategory (thumbnail, display, print, print_lead), Width, Height, and a file URL (filename only).
  • Prefer ordering by Sort (ascending).
Standard Image Sizes
  • print_lead ≈ 2400 px (≈ 2.5 MB)
  • print ≈ 1200 px (≈ 1 MB)
  • display ≈ 450 px (≈ 130 KB)
  • thumbnail ≈ 200 px (≈ 40 KB)
Download rule: construct the full image URL using the hotel code and filename; store images locally for runtime use. http://tkimages.axisdata.net/ImageConverter.php?size={DimensionCategory}&height={Height}&hotel={HotelCode}&filename={URL} Example: size=print&height=1200&hotel=AMTSBG11C&filename=01.jpg
  • Images are not for hotlinking; partners must download & serve from their CDNs.
  • Test systems don’t serve images; use production. Show images by Sort (lower = higher priority).
  • If originals are low quality, some sizes/categories may be missing.
<MultimediaDescriptions>
    <MultimediaDescription>
        <ImageItems>
            <ImageItem Category="HOTELEXTERIOR" ID="1" LastModifyDateTime="2017-04-12T10:44:48">
                <ImageFormat UnitOfMeasureCode="9" Width="3543" Height="1877" Format="6" FileName="facade_1.jpg" DimensionCategory="original" Sort="1" Title="Hotel exterior" RecordID="1">
                <URL>facade.jpg</URL>
                </ImageFormat>
                ...
            </ImageItem>
            <ImageItem Category="HOTELEXTERIOR" ID="1" LastModifyDateTime="2017-04-12T10:44:48">
                <ImageFormat UnitOfMeasureCode="9" Width="3543" Height="1879" Format="6" FileName="cathedral_1.jpg" DimensionCategory="original" Sort="2" Title="Hotel exterior" RecordID="1">
                <URL>Cathedral.jpg</URL>
                </ImageFormat>
                <ImageFormat UnitOfMeasureCode="9" Width="377" Height="200" Format="6" FileName="cathedral_2.jpg" DimensionCategory="thumbnail" Sort="2" Title="Hotel exterior" RecordID="2">
                <URL>Cathedral.jpg</URL>
                </ImageFormat>
            ...
</MultimediaDescriptions>

ContactInfos

Postal address, phone, email, and web URL for the property and/or supplier contact.
<ContactInfos>
    <ContactInfo Location="6">
        <Addresses>
            <Address>
                <AddressLine>C/. saten 8</AddressLine>
                <CityName>San Bartolome</CityName>
                <PostalCode>35562</PostalCode>
                <Country>ES</Country>
                <StateProv>Lanzarote</StateProv>
                <CountryName>Spain</CountryName>
            </Address>
        </Addresses>
        <Phones>
            <Phone PhoneTechType="1" PhoneNumber="555 55 55 55"/>
        </Phones>
        <Emails>
            <Email>fake_int@axisdata.net</Email>
        </Emails>
        <URLs>
            <URL Type="Web">www.fakeweb.com</URL>
        </URLs>
    </ContactInfo>
    <ContactInfo Location="7">
        <CompanyName Code="ACE">MTS Globe Spain -Lanzarote</CompanyName>
    </ContactInfo>
</ContactInfos>

CodeConversions

DRV GlobalType mappings for hotel, room, and board levels. Requires DRV license. Entries use repeated CodeConversion elements with nested DRVGlobalTypes/DRVGlobalType/GTAttribute and optional Description. Check complete example below to view in response.

Behavior & Switches

If an enrichment switch is present in the request and set to false, the corresponding section is omitted in the response.
  • HotelInfo SendData="false" → omits Descriptions and Services.
  • ContactInfo SendData="false" → omits address block.
  • AreaInfo SendRefPoints="false" → omits RefPoints.
  • AffiliationInfo SendAwards="false" → omits Awards.
  • MultimediaObjects SendData="false" → omits images.

Complete Examples

<OTA_HotelDescriptiveInfoRS xmlns="http://www.opentravel.org/OTA/2003/05" Version="2009.1" TransactionIdentifier="1-37/37">
  <Success/>
  <HotelDescriptiveContents>
      <HotelDescriptiveContent LanguageCode="EN" RPH="7" HotelCode="A9L2M7K3QW" HotelName="John Hotel" HotelCodeContext="123456" ChainName="Generic Chain A" LastModifiedDate="2024-03-20T14:55:53"/>
      <HotelDescriptiveContent LanguageCode="EN" RPH="22" HotelCode="A8N4P1R6TY" HotelName="Alice Hotel" HotelCodeContext="654321" ChainName="Generic Chain C" LastModifiedDate="2024-08-21T09:11:41"/>
      <HotelDescriptiveContent LanguageCode="EN" RPH="58" HotelCode="A7V3X9M2LK" HotelName="Bob Hotel" HotelCodeContext="789012" LastModifiedDate="2024-06-24T13:01:07"/>
      <HotelDescriptiveContent LanguageCode="EN" RPH="64" HotelCode="A1Q8W4E7ZC" HotelName="Emma Hotel" HotelCodeContext="345678" ChainName="Generic Chain D" LastModifiedDate="2025-02-25T11:09:49"/>
      <HotelDescriptiveContent LanguageCode="EN" RPH="65" HotelCode="A5R9Y2U3OP" HotelName="Liam Hotel" HotelCodeContext="987654" LastModifiedDate="2024-06-25T16:46:47"/>
      <HotelDescriptiveContent LanguageCode="EN" RPH="97" HotelCode="A3K6J8L0NM" HotelName="Olivia Hotel" HotelCodeContext="234567" ChainName="Generic Chain B" LastModifiedDate="2024-11-28T10:10:09"/>
  </HotelDescriptiveContents>
</OTA_HotelDescriptiveInfoRS>

Best Practices

  1. Use a two-step flow: Hotel List (minimal) → Hotel Details (per property, in needed languages).
  2. Prefer LastUpdateDate deltas daily; subtract ~3 hours as a safety margin for time-zone skew.
  3. When downloading media, sort and present by ImageFormat@Sort; issue HTTP HEAD to compare Last-Modified before downloading.
  4. Persist images and static data; do not hotlink image URLs at runtime.
  5. DRV and GIATA/TTI codes are license‑bound; enable per partner before relying on those fields.