Retrieve a property's details

Use /ota/OTA_HotelDescriptiveInfo to retrieve a property's details.

Before you start

You need:

Request

HTTP request

POST https://supply-xml.booking.com/hotels/ota/OTA_HotelDescriptiveInfo

Request body

Provide an OTA_HotelDescriptiveInfoRQ object in the request body. Example:

<OTA_HotelDescriptiveInfoRQ>
    <HotelDescriptiveInfos>
      <!-- Replace the {PlaceHolder} in the following line! -->
        <HotelDescriptiveInfo
          HotelCode="{PropertyID}"></HotelDescriptiveInfo>
    </HotelDescriptiveInfos>
</OTA_HotelDescriptiveInfoRQ>

Response

The response contains an OTA_HotelDescriptiveInfoRS object:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelDescriptiveInfoRS xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.opentravel.org/OTA/2003/05 OTA_HotelDescriptiveInfoRS.xsd" TimeStamp="2017-05-15T13:23:49+00:00" Target="Production" Version="1.006">
<HotelDescriptiveContents>
  <HotelDescriptiveContent HotelName="The Best Hotel" LanguageCode="en" ID="{PropertyID}" PropertyLicenseNumber="{license}" Status="Open / bookable" CurrencyCode="EUR">
    <HotelInfo>
      <CategoryCodes>
        <GuestRoomInfo Quantity=""/>
        <HotelCategory Code="20"/>
      </CategoryCodes>
      <Languages>
        <Language LanguageCode="fr"/>
      </Languages>
      <Descriptions>
        <MultimediaDescriptions>
          <MultimediaDescription>
            <TextItems>
              <TextItem>
                <Description>Booking.com url</Description>
                <URL>https://booking.com/hotel/de/dontstayhere.en.html</URL>
              </TextItem>
            </TextItems>
          </MultimediaDescription>
        </MultimediaDescriptions>
      </Descriptions>
      <Position Longitude="1.09" Latitude="49.4092"/>
      <Services>
        <Service Code="79"/>
        <Service Code="173" Price="10" CurrencyCode="EUR">
          <Types>
            <Type Code="5003"/>
            <Type Code="5004"/>
            <Type Code="5010"/>
            <Type Code="5011"/>
          </Types>
          <Items>
            <Item Code="5001"/>
            <Item Code="5003"/>
            <Item Code="5004"/>
            <Item Code="5007"/>
            <Item Code="5009"/>
            <Item Code="5010"/>
            <Item Code="5011"/>
            <Item Code="5016"/>
          </Items>
          <OperationTimes>
            <OperationTime Sat="1" Sun="1" Start="09:00" End="11:30"/>
            <OperationTime Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Start="08:00" End="10:00"/>
          </OperationTimes>
        </Service>
        <Service Code="6001" Price="15" CurrencyCode="EUR"/>
      </Services>
      <OwnershipManagementInfos>
        <OwnershipManagementInfo>
          <CompanyName Code="{1234}"/>
        </OwnershipManagementInfo>
      </OwnershipManagementInfos>
      <RelativePositions>
        <RelativePosition>
          <Transportations>
            <Transportation>
              <TPA_Extensions>
                <Route>
                  <Leg>
                    <Start Code="URO" Type="airport"/>
                    <TransportType Code="5000"/>
                    <Line Name="10"/>
                    <Departure UponArrangement="1"/>
                  </Leg>
                  <JourneyTime Minutes="20"/>
                  <Price Amount="10" CurrencyCode="EUR"/>
                </Route>
              </TPA_Extensions>
            </Transportation>
            <Transportation>
              <TPA_Extensions>
                <Route>
                  <Leg>
                    <Start Code="URO" Type="airport"/>
                    <TransportType Code="21"/>
                    <Line Name="10"/>
                    <Departure Interval="20"/>
                  </Leg>
                  <JourneyTime Minutes="20"/>
                  <Price Amount="5.5" CurrencyCode="EUR"/>
                </Route>
              </TPA_Extensions>
            </Transportation>
          </Transportations>
        </RelativePosition>
      </RelativePositions>
      <TPA_Extensions>
        <AcceptedPayments>
          <AcceptedPayment PaymentTypeCode="1"/>
          <AcceptedPayment PaymentTypeCode="2"/>
          <AcceptedPayment PaymentTypeCode="3"/>
        </AcceptedPayments>
      </TPA_Extensions>
    </HotelInfo>
    <FacilityInfo>
      <GuestRooms>
        <!--
                ID:           Booking.com room id
              DescriptiveText:  Room name
        -->
        <GuestRoom ID="217462803" Active="1" RoomTypeName="Double" MaxOccupancy="2" NonSmoking="0" LicenseNumber="{license}" SizeMeasurement="25.00" SizeMeasurementUnit="sqm">
          <Amenity RoomAmenityCode="11"/>
          <Amenity RoomAmenityCode="88"/>
          <Amenity RoomAmenityCode="28"/>
          <Amenity RoomAmenityCode="50"/>
          <Amenity RoomAmenityCode="55"/>
          <Amenity RoomAmenityCode="107"/>
          <RoomLocation RoomLocationCode="3">
            <Floors>
              <Floor Number="0"/>
              <Floor Number="5"/>
              <Floor Number="7"/>
              <Floor Number="9"/>
            </Floors>
          </RoomLocation>
          <DescriptiveText>Deluxe Double Room</DescriptiveText>
        </GuestRoom>
        <GuestRoom ID="217462802" Active="1" RoomTypeName="Double" MaxOccupancy="2" NonSmoking="0" LicenseNumber="{license}" SizeMeasurement="25.00" SizeMeasurementUnit="sqm">
          <Amenity RoomAmenityCode="55"/>
          <Amenity RoomAmenityCode="107"/>
          <Amenity RoomAmenityCode="50"/>
          <Amenity RoomAmenityCode="59"/>
          <Amenity RoomAmenityCode="28"/>
          <Amenity RoomAmenityCode="11"/>
          <Amenity RoomAmenityCode="88"/>
          <RoomLocation RoomLocationCode="3">
            <Floors>
              <Floor Number="0"/>
              <Floor Number="3"/>
            </Floors>
          </RoomLocation>
          <DescriptiveText>Deluxe Double Room with Sea View</DescriptiveText>
        </GuestRoom>
        <GuestRoom ID="217462804" Active="1" RoomTypeName="Apartment" MaxOccupancy="2" NonSmoking="1" LicenseNumber="{license}" SizeMeasurement="30.00" SizeMeasurementUnit="sqm">
          <Amenity RoomAmenityCode="50"/>
          <Amenity RoomAmenityCode="55"/>
          <Amenity RoomAmenityCode="107"/>
          <Amenity RoomAmenityCode="88"/>
          <Amenity RoomAmenityCode="11"/>
          <Amenity RoomAmenityCode="28"/>
          <RoomLocation RoomLocationCode="2"/>
          <DescriptiveText>Folterkammer</DescriptiveText>
          <TPA_Extensions>
            <SubRooms>
              <SubRoom RoomType="Bedroom" PrivateBathroom="1" MaxGuests="2">
                <Amenities>
                  <Amenity AmenityCode="203" Value="1"/>
                  <Amenity AmenityCode="200" Value="2"/>
                </Amenities>
              </SubRoom>
              <SubRoom RoomType="Living Room" MaxGuests="4">
                <Amenities>
                  <Amenity AmenityCode="102" Value="2"/>
                </Amenities>
              </SubRoom>
              <SubRoom RoomType="Bathroom" Number="1"/>
            </SubRooms>
          </TPA_Extensions>
        </GuestRoom>
      </GuestRooms>
      <Restaurants>
        <Restaurant RestaurantName="Antekoje" OfferLunch="1" OfferDinner="1">
          <CuisineCodes>
            <CuisineCode Code="49"/>
            <CuisineCode Code="51"/>
          </CuisineCodes>
          <OperationSchedules>
            <OperationSchedule>
              <OperationTimes>
                <OperationTime Mon="1" Tue="1" Weds="1" Thur="1" Fri="1" Sat="1" Sun="1" Start="17:30:00" End="22:00:00"/>
                <OperationTime Sat="1" Sun="1" Start="11:00:00" End="14:30:00"/>
              </OperationTimes>
            </OperationSchedule>
          </OperationSchedules>
          <Features>
            <Feature DescriptiveText="buffet"/>
            <Feature DescriptiveText="outdoor seating"/>
            <Feature DescriptiveText="accepts reservations"/>
            <Feature DescriptiveText="a la carte"/>
          </Features>
          <TPA_Extensions>
            <Ambiances>
              <Ambiance Name="modern"/>
            </Ambiances>
            <DietaryOptions>
              <DietaryOption Name="gluten free"/>
              <DietaryOption Name="vegan"/>
            </DietaryOptions>
          </TPA_Extensions>
        </Restaurant>
      </Restaurants>
    </FacilityInfo>
    <Policies>
      <Policy>
        <PolicyInfo CheckInTime="16:00" CheckOutTime="11:00"/>
        <PetsPolicy PetsAllowedCode="Pets Not Allowed">
          <PetsPolicy NonRefundableFee="charges_may_apply"/>
        </PetsPolicy>
        <CancelPolicy>
          <CancelPenalty PolicyCode="1" Description="The guest will be charged the total price if they cancel at any time.">
            <TPA_Extensions>
              <NoShowPolicy Penalty="default"/>
            </TPA_Extensions>
          </CancelPenalty>
        </CancelPolicy>
        <GuaranteePaymentPolicy>
          <GuaranteePayment PolicyCode="1" Description="The guest will be charged a prepayment of the total price at any time.">
            <TPA_Extensions>
              <PrepaymentPolicy EffectiveFrom="after_cancellation_fee_begins"/>
            </TPA_Extensions>
          </GuaranteePayment>
        </GuaranteePaymentPolicy>
        <TaxPolicies>
          <TaxPolicy Code="36" Amount="0.00" Type="Inclusive"/>
          <TaxPolicy Code="3" Amount="1.00" Type="Inclusive" ChargeFrequency="21"/>
        </TaxPolicies>
        <FeePolicies>
          <FeePolicy Code="5009" Amount="10.00" Type="Conditional" ChargeFrequency="12">
            <TPA_Extensions>
              <Conditions>
                <Condition Type="guest_smokes"/>
              </Conditions>
            </TPA_Extensions>
          </FeePolicy>
          <FeePolicy Code="5010" Amount="10.00" Type="Inclusive" ChargeFrequency="12"/>
          <FeePolicy Code="5035" Type="Inclusive">
            <TPA_Extensions>
              <InternetFeePolicy InternetType="wifi" InternetCoverage="public_areas"/>
            </TPA_Extensions>
          </FeePolicy>
          <FeePolicy Code="5036" Type="Exclusive" ChargeFrequency="1">
            <TPA_Extensions>
              <ParkingFeePolicy ParkingType="location_nearby" ParkingReservation="not_available" ParkingProperty="public"/>
            </TPA_Extensions>
          </FeePolicy>
        </FeePolicies>
      </Policy>
    </Policies>
    <AffiliationInfo>
      <Awards>
        <Award Rating="0.0"/>
      </Awards>
    </AffiliationInfo>
    <ContactInfos>
      <ContactInfo ContactProfileType="PhysicalLocation">
        <Addresses>
          <Address>
            <AddressLine>15 Station Street</AddressLine>
            <CityName>Sotteville</CityName>
            <PostalCode>76000</PostalCode>
            <CountryName>fr</CountryName>
          </Address>
          <Address Language="fr">
            <HotelName>Le Faux Hôtel 001</HotelName>
            <AddressLine>15 Rue de la Gare</AddressLine>
            <CityName>sotteville-lès-rouen</CityName>
            <PostalCode>76000</PostalCode>
            <CountryName>fr</CountryName>
          </Address>
        </Addresses>
      </ContactInfo>
      <ContactInfo ContactProfileType="availability">
        <Names>
          <Name Language="xt" Gender="female">Carol Xu
            <JobTitle>General Manager</JobTitle>
          </Name>
        </Names>
        <Addresses>
          <Address>
            <AddressLine>1000 Eighth Avenue</AddressLine>
            <CityName>New York</CityName>
            <PostalCode>10000</PostalCode>
            <CountryName>us</CountryName>
          </Address>
        </Addresses>
        <Emails>
          <Email>carol.xu@fakehotel.com</Email>
        </Emails>
        <Phones>
          <Phone PhonesNumber="+3162222220" PhoneTechType="1" Extension="30"/>
          <Phone PhonesNumber="+3162222221" PhoneTechType="1" Extension="30"/>
          <Phone PhonesNumber="+3162222222" PhoneTechType="1" Extension="30"/>
          <Phone PhonesNumber="+3162222224" PhoneTechType="3"/>
          <Phone PhonesNumber="+3162222223" PhoneTechType="5"/>
        </Phones>
      </ContactInfo>
      <ContactInfo ContactProfileType="availability">
        <Names>
          <Name Language="en" Gender="male">Steve Martin
            <JobTitle>Admin</JobTitle>
          </Name>
        </Names>
        <Addresses>
          <Address>
            <AddressLine>200 rue de la Pubelle</AddressLine>
            <CityName>Sotteville</CityName>
            <PostalCode>76000</PostalCode>
            <CountryName>fr</CountryName>
          </Address>
        </Addresses>
        <Emails>
          <Email>admin@fakehotel.com</Email>
        </Emails>
        <Phones>
          <Phone PhonesNumber="+3362211110" PhoneTechType="1" Extension="30"/>
          <Phone PhonesNumber="+3362211111" PhoneTechType="1" Extension="30"/>
          <Phone PhonesNumber="+3362211112" PhoneTechType="1" Extension="30"/>
          <Phone PhonesNumber="+3362211114" PhoneTechType="3"/>
          <Phone PhonesNumber="+3362211113" PhoneTechType="5"/>
        </Phones>
      </ContactInfo>
      <ContactInfo ContactProfileType="invoices">
        <Names>
          <Name>Carol Xu</Name>
        </Names>
        <Addresses>
          <Address>
            <AddressLine>1000 Eighth Avenue</AddressLine>
            <CityName>New York</CityName>
            <PostalCode>10000</PostalCode>
            <CountryName>us</CountryName>
          </Address>
        </Addresses>
        <Emails>
          <Email>carol.xu@fakehotel.com</Email>
        </Emails>
        <Phones>
          <Phone PhonesNumber="+3162222220" PhoneTechType="1" Extension="30"/>
        </Phones>
      </ContactInfo>
    </ContactInfos>
    <TPA_Extensions>
      <StandardPhrases>
        <StandardPhrase Enabled="1" Name="GuestIdentification"/>
        <StandardPhrase Enabled="1" Name="InformArrivalTime"/>
        <StandardPhrase Enabled="1" Name="PayBeforeStay"/>
        <StandardPhrase Enabled="1" Name="TattooRestriction"/>
        <StandardPhrase Enabled="1" Name="Renovation">
          <Options>
            <Option Name="RenovationFrom">2017-01-01</Option>
            <Option Name="RenovationUntil">2017-12-31</Option>
          </Options>
        </StandardPhrase>
        <StandardPhrase Enabled="1" Name="SecurityDeposit">
          <Options>
            <Option Name="SecurityDepositAmount">10.43</Option>
            <Option Name="SecurityDepositReturnMethod">cash</Option>
            <Option Name="SecurityDepositReturnWhen">on_checkout</Option>
            <Option Name="SecurityDepositCollectNumDays">0</Option>
            <Option Name="SecurityDepositCollectMethod">cash</Option>
            <Option Name="SecurityDepositCollectWhen">upon_arrival</Option>
          </Options>
        </StandardPhrase>
      </StandardPhrases>
      <SellMealsThroughBooking Enabled="1"/>
      <TotalNumberOfFloors Number="10"/>
    </TPA_Extensions>
  </HotelDescriptiveContent>
</HotelDescriptiveContents>
</OTA_HotelDescriptiveInfoRS><!-- RUID: [XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX...] -->

Next steps