Retrieve a property's details

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

Simplifying room type amenity codes

To avoid duplicates in room amenity codes, the system now groups certain codes together that refer to the same or similar amenity. In practice, this means that any of these grouped codes internally default to the same code. For example, using any of the codes with desk, which are 28 (Desk), 29 (Desk with lamp) and 64 (Large desk), internally default to 28 (Desk). So even when you set code 29, when you retrieve the amenity with the OTA_HotelDescriptiveInfo endpoint, it shows as 28.

To learn more about which codes default to what, see [room type amenity codes.][[room-type-amenities]]

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="28"/>
                        <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." PolicyName="PTT_NON_REFUNDABLE">
                            <TPA_Extensions>
                                <NoShowPolicy Penalty="total_price"/>
                            </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"/>
                </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