← Step 1 – Create property | Step 3 – Create room type →


Step 2 – Retrieve property details

You have learned to create a property and update a field. Now is a good time to retrieve your property's details from the API. We recommend doing this regularly – before you update a field, for example – to make sure you and Booking.com are working with the same information.

Use the OTA_HotelDescriptiveInfo endpoint to retrieve your property's details:

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

The request body should contain your property's ID, like so:

<OTA_HotelDescriptiveInfoRQ>
  <HotelDescriptiveInfos>      
    <HotelDescriptiveInfo HotelCode="{PropertyID}"></HotelDescriptiveInfo>        
  </HotelDescriptiveInfos>
</OTA_HotelDescriptiveInfoRQ>

The response is long, so we won't give a full example here, but the first few lines look like this:

<?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="2018-02-07T14:08:01+00:00"
  Target="Production"
  Version="1.006">
    <HotelDescriptiveContents>
        <HotelDescriptiveContent
          HotelName="The Best Hotel"
          LanguageCode="en"
          ID="1234567"
          Status="Test Hotel"
          CurrencyCode="EUR">
<!-- Skipping lines for brevity. -->
        </HotelDescriptiveContent>
    </HotelDescriptiveContents>
</OTA_HotelDescriptiveContentNotifRS>
<!-- RUID: [UmFuZG9tSVY...] -->

The HotelDescriptiveContent[@Status] attribute tells you the current status of your property. Because this is a test property, the status will never change from Test Hotel.

The rest of the body contains all the fields you set earlier. But you might also notice some other things:

  • A MultiMediaDescriptions element with some placeholders. This is where your property photos go.
  • A number of Policy elements with default settings related to pets and taxes.

Learn more about the last call here: OTA_HotelDescriptiveInfo


← Step 1 – Create property | Step 3 – Create room type →