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="2020-04-29T09:09:13+00:00" Target="Test" Version="1.006">
    <HotelDescriptiveContents>
        <HotelDescriptiveContent HotelName="Stefan's XML Guest House" LanguageCode="en" ID="3934781" Status="Test Hotel" CurrencyCode="AUD">
            <HotelInfo>
                <CategoryCodes>
                    <GuestRoomInfo Quantity="3"/>
                    <HotelCategory Code="40"/>
                </CategoryCodes>
                <Descriptions>
                    <MultimediaDescriptions>
                        <MultimediaDescription>
                            <TextItems>
                                <TextItem>
                                    <Description>Booking.com url</Description>
                                    <URL/>
                                </TextItem>
                            </TextItems>
                        </MultimediaDescription>
                    </MultimediaDescriptions>
                </Descriptions>
                <Position Longitude="151.246281719149" Latitude="-33.912774074125"/>
                <Services>
                    <Service Code="198"/>
                    <Service Code="5" Included="unknown"/>
                </Services>
                <OwnershipManagementInfos>
                    <OwnershipManagementInfo>
                        <CompanyName Code="52383"/>
                    </OwnershipManagementInfo>
                </OwnershipManagementInfos>
                <RelativePositions>
                    <RelativePosition>
                        <Transportations/>
                    </RelativePosition>
                </RelativePositions>
                <TPA_Extensions>
                    <AcceptedPayments/>
                    <PaymentPreferences NoCVC="1"/>
                </TPA_Extensions>
            </HotelInfo>
            <FacilityInfo>
                <GuestRooms>
                    <GuestRoom ID="393478102" Active="1" RoomTypeName="Double" NonSmoking="1" SizeMeasurement="9999.99" SizeMeasurementUnit="sqft">
                        <Amenity RoomAmenityCode="15"/>
                        <Amenity RoomAmenityCode="2"/>
                        <Amenity RoomAmenityCode="251"/>
                        <DescriptiveText>Double Room</DescriptiveText>
                        <Occupancy MaxOccupancy="2" MaxAdultOccupancy="2" MaxChildOccupancy="0"/>
                        <Quantities MaxCribs="0" MaxRollaways="0"/>
                    </GuestRoom>
                    <GuestRoom ID="393478104" Active="1" RoomTypeName="Holiday home" NonSmoking="1" SizeMeasurement="85.00" SizeMeasurementUnit="sqm">
                        <Amenity RoomAmenityCode="224"/>
                        <Amenity RoomAmenityCode="18"/>
                        <Amenity RoomAmenityCode="166"/>
                        <Amenity RoomAmenityCode="88"/>
                        <Amenity RoomAmenityCode="11"/>
                        <Amenity RoomAmenityCode="2"/>
                        <Amenity RoomAmenityCode="92"/>
                        <Amenity RoomAmenityCode="123"/>
                        <Amenity RoomAmenityCode="157"/>
                        <Amenity RoomAmenityCode="5086"/>
                        <Amenity RoomAmenityCode="55"/>
                        <Amenity RoomAmenityCode="5129"/>
                        <Amenity RoomAmenityCode="142"/>
                        <Amenity RoomAmenityCode="50"/>
                        <Amenity RoomAmenityCode="5124"/>
                        <Amenity RoomAmenityCode="77"/>
                        <Amenity RoomAmenityCode="59"/>
                        <Amenity RoomAmenityCode="5034"/>
                        <Amenity RoomAmenityCode="7"/>
                        <Amenity RoomAmenityCode="8"/>
                        <Amenity RoomAmenityCode="105"/>
                        <DescriptiveText>Holiday Home</DescriptiveText>
                        <TPA_Extensions>
                            <SubRooms>
                                <SubRoom RoomType="Bedroom" MaxGuests="2">
                                    <Amenities>
                                        <Amenity AmenityCode="249" Value="1"/>
                                    </Amenities>
                                </SubRoom>
                                <SubRoom RoomType="Bedroom" MaxGuests="2">
                                    <Amenities>
                                        <Amenity AmenityCode="203" Value="2"/>
                                    </Amenities>
                                </SubRoom>
                                <SubRoom RoomType="Bathroom" Number="1"/>
                            </SubRooms>
                        </TPA_Extensions>
                        <Occupancy MaxOccupancy="4" MaxAdultOccupancy="4" MaxChildOccupancy="0"/>
                        <Quantities MaxCribs="0" MaxRollaways="0"/>
                    </GuestRoom>
                    <GuestRoom ID="393478103" Active="1" RoomTypeName="Holiday home" NonSmoking="1" SizeMeasurement="85.00" SizeMeasurementUnit="sqm">
                        <Amenity RoomAmenityCode="105"/>
                        <Amenity RoomAmenityCode="7"/>
                        <Amenity RoomAmenityCode="8"/>
                        <Amenity RoomAmenityCode="5034"/>
                        <Amenity RoomAmenityCode="59"/>
                        <Amenity RoomAmenityCode="77"/>
                        <Amenity RoomAmenityCode="50"/>
                        <Amenity RoomAmenityCode="5124"/>
                        <Amenity RoomAmenityCode="5129"/>
                        <Amenity RoomAmenityCode="142"/>
                        <Amenity RoomAmenityCode="5086"/>
                        <Amenity RoomAmenityCode="55"/>
                        <Amenity RoomAmenityCode="157"/>
                        <Amenity RoomAmenityCode="123"/>
                        <Amenity RoomAmenityCode="92"/>
                        <Amenity RoomAmenityCode="2"/>
                        <Amenity RoomAmenityCode="11"/>
                        <Amenity RoomAmenityCode="18"/>
                        <Amenity RoomAmenityCode="88"/>
                        <Amenity RoomAmenityCode="166"/>
                        <Amenity RoomAmenityCode="224"/>
                        <DescriptiveText>Vacation Home</DescriptiveText>
                        <TPA_Extensions>
                            <SubRooms>
                                <SubRoom RoomType="Bedroom" MaxGuests="2">
                                    <Amenities>
                                        <Amenity AmenityCode="249" Value="1"/>
                                    </Amenities>
                                </SubRoom>
                                <SubRoom RoomType="Bedroom" MaxGuests="2">
                                    <Amenities>
                                        <Amenity AmenityCode="203" Value="2"/>
                                    </Amenities>
                                </SubRoom>
                                <SubRoom RoomType="Bathroom" Number="1"/>
                            </SubRooms>
                        </TPA_Extensions>
                        <Occupancy MaxOccupancy="4" MaxAdultOccupancy="4" MaxChildOccupancy="1"/>
                        <Quantities MaxCribs="1" MaxRollaways="0"/>
                    </GuestRoom>
                </GuestRooms>
                <Restaurants/>
            </FacilityInfo>
            <Policies>
                <Policy>
                    <PolicyInfo CheckInTime="15:00-20:00" CheckOutTime="12:00" MinGuestAge="0" AcceptedGuestType="ChildrenAllowed"/>
                    <PetsPolicies PetsAllowedCode="Pets Not Allowed">
                        <PetsPolicy NonRefundableFee="free"/>
                    </PetsPolicies>
                    <CancelPolicy>
                        <CancelPenalty PolicyCode="1" Description="The guest will be charged the total price of the reservation 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 of the reservation at any time.">
                            <TPA_Extensions>
                                <PrepaymentPolicy EffectiveFrom="after_reservation_is_made"/>
                            </TPA_Extensions>
                        </GuaranteePayment>
                    </GuaranteePaymentPolicy>
                    <TaxPolicies/>
                    <FeePolicies>
                        <FeePolicy Code="44" Amount="0" ChargeFrequency="20" MinAge="0" MaxAge="3"/>
                        <FeePolicy Code="44" Amount="3100" DecimalPlaces="2" ChargeFrequency="21" MinAge="4" MaxAge="12"/>
                        <FeePolicy Code="37" Amount="2400" DecimalPlaces="2" ChargeFrequency="20" MinAge="0" MaxAge="3"/>
                    </FeePolicies>
                </Policy>
            </Policies>
            <AffiliationInfo>
                <Awards>
                    <Award Rating="0.0"/>
                </Awards>
            </AffiliationInfo>
            <ContactInfos>
                <ContactInfo ContactProfileType="PhysicalLocation">
                    <Addresses>
                        <Address>
                            <AddressLine>1 Infinite Loop</AddressLine>
                            <CityName>Amsterdam</CityName>
                            <PostalCode>1017CE</PostalCode>
                            <CountryName>nl</CountryName>
                        </Address>
                    </Addresses>
                </ContactInfo>
                <ContactInfo ContactProfileType="general">
                    <Names>
                        <Name Language="en">
                            <GivenName>Sodkha Kpxrphvi</GivenName>
                        </Name>
                    </Names>
                    <Addresses/>
                    <Emails>
                        <Email>test@booking.com</Email>
                    </Emails>
                    <Phones>
                        <Phone PhonesNumber="+41841626269" PhoneTechType="1" Extension="30"/>
                    </Phones>
                </ContactInfo>
                <ContactInfo ContactProfileType="invoices">
                    <Names>
                        <Name>
                            <GivenName>Sodkha Kpxrphvi</GivenName>
                        </Name>
                    </Names>
                    <Addresses>
                        <Address>
                            <AddressLine>Dbiuonyfuva 145</AddressLine>
                            <CityName>Asxvmbdkj</CityName>
                            <PostalCode>6528 TR</PostalCode>
                            <CountryName>nl</CountryName>
                        </Address>
                    </Addresses>
                    <Phones>
                        <Phone PhonesNumber="+41841626269" PhoneTechType="1" Extension="30"/>
                    </Phones>
                </ContactInfo>
            </ContactInfos>
            <TPA_Extensions>
                <StandardPhrases>
                    <StandardPhrase Name="SecurityDeposit" Enabled="1"/>
                    <StandardPhrase Name="NoHenStagParty" Enabled="1"/>
                </StandardPhrases>
                <GuestInformation RequireGuestAddress="0" RequireGuestContactNumber="0" RequireMinimumStay="0"/>
                <PreventLikelyToBeCancelledBookings Enabled="0"/>
                <SellMealsThroughBooking Enabled="0"/>
            </TPA_Extensions>
        </HotelDescriptiveContent>
    </HotelDescriptiveContents>
</OTA_HotelDescriptiveInfoRS><!-- RUID: [XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX...] -->

Next steps