Retrieve property attributes¶

Use /ota/OTA_HotelSearch to retrieve the attributes of one or more Property.

Request¶

HTTP request¶

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

Request body¶

Provide an OTA_HotelSearchRQ object in the request body. Example:

<OTA_HotelSearchRQ xmlns="http://www.opentravel.org/OTA/2003/05" Version="2.001">
  <Criteria>
    <Criterion>
      <!-- Replace the {PlaceHolder} in the following line! -->
      <HotelRef HotelCode="{PropertyID}"/>
    </Criterion>
  </Criteria>
</OTA_HotelSearchRQ>

Alternatively, omit Criteria to retrieve the statuses of all properties that are assigned to the used machine account. Consider using Pagination in this case.

Response¶

The response contains an OTA_HotelSearchRS object:

<OTA_HotelSearchRS
    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_HotelSearchRS.xsd" TimeStamp="2015-12-02T15:07:34-00:00" Target="Production" Version="3.000">
    <Properties LastChange="2015-12-01 12:00:00">
        <Property HotelCode="{PropertyID}" HotelName="The Best Hotel" CurrencyCode="EUR">
            <TPA_Extensions HotelStatus="XML: Being built" Created="2015-11-19 07:13:06" LastChange="2015-12-01 16:41:53" ContentScore="67" ConnectionStatus="Pending Property"/>
        </Property>
    </Properties>
</OTA_HotelSearchRS>

ContentScore is calculated periodically. It may take a while for your changes to reflect on the score.

Pagination¶

Because the amount of properties can be big, retrieving all of them at once can cause issues. Therefore you can request properties in batches by adding the TPA_Extensions->Pagination object to the request body.

Pagination element expects 2 parameters:

Page - number of requested page
PageSize - amount of elements per page. We recommend using 100 as PageSize.

Pagination element outputs 4 parameters:

TotalAmount - total number of hotels found
Page - number of requested page
PageSize - size of the page
PagesCount - total amount of pages of current PageSize

NOTE: You can only use one parameter at a time, so Pagination OR Criteria.

NOTE: Results are sorted in ascending order of HotelCode.

Pagination - Request Example¶

<OTA_HotelSearchRQ xmlns="http://www.opentravel.org/OTA/2003/05" Version="2.001" >
    <TPA_Extensions>
        <Pagination Page="1" PageSize="100"/>
    </TPA_Extensions>
</OTA_HotelSearchRQ>

Pagination - Response Example¶

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelSearchRS 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_HotelSearchRS.xsd" TimeStamp="2019-12-23T14:18:06+00:00" Target="Test" Version="3.000">
    <TPA_Extensions>
        <Pagination TotalAmount="3500" PagesCount="35" Page="1" PageSize="100"/>
    </TPA_Extensions>
    <Properties>
        <Property HotelCode="{PropertyID}" HotelName="The Best Hotel" CurrencyCode="EUR">
            <TPA_Extensions HotelStatus="XML: Being built" Created="2015-11-19 07:13:06" LastChange="2015-12-01 16:41:53" ContentScore="67" ConnectionStatus="Pending Property"/>
        </Property>
        ...
        <Property HotelCode="{PropertyID}" HotelName="The Best Hotel 2" CurrencyCode="EUR">
            <TPA_Extensions HotelStatus="XML: Being built" Created="2015-12-15 03:23:01" LastChange="2016-12-01 16:41:53" ContentScore="68" ConnectionStatus="Pending Property"/>
        </Property>
    </Properties>
</OTA_HotelSearchRS>

Next steps¶

Is this page helpful? Yes | No