Modify a property's facilities

Use the OTA_HotelDescriptiveContentNotif endpoint to add or modify a property's facility details such as gyms, restaurants, swimming pools or others.

Before you start

Before adding or editing a property's facilities information, use the OTA_HotelDescriptiveInfo endpoint to retrieve the existing amenities/facilities details. For more information, see Retrieving a property's details.

Make sure to add the existing amenity codes along with the new amenity codes when calling the OTA_HotelDescriptiveContentNotif endpoint.

Exercise caution while using the Overlay mode

Content API uses an overlay system. Every time you update an existing property, room type, or other object, the body of your request replaces whatever information was stored in our servers at that time. This means existing information may be deleted if you don't include it in your request.

To update an object without deleting information, make sure your request contains both the fields you want to update and those you want to keep the same. Copy/paste sample requests from this page at your own risk.

You need:

property ID

Request

HTTP request

https://supply-xml.booking.com/hotels/ota/OTA_HotelDescriptiveContentNotif

Request body

Provide an OTA_HotelDescriptiveContentNotifRQ object in the request body.
Specify services in a Services object.
Specify facilities in a FacilityInfo object.

Example:

<!-- WARNING: This request overlays existing objects. Copy/pasting may lead to loss of information. -->
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelDescriptiveContentNotifRQ
  xmlns="http://www.opentravel.org/OTA/2003/05"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  PrimaryLangID="en-us"
  EchoToken="GUID"
  xsi:schemaLocation="http://www.opentravel.org/2014B/OTA_HotelDescriptiveContentNotifRQ.xsd"
  id="OTA2014B"
  Version="8.0"
  Target="Production">
  <HotelDescriptiveContents>
    <HotelDescriptiveContent
      LanguageCode="en"
      HotelDescriptiveContentNotifType="Overlay"
      HotelCode="{PropertyID}">
      <HotelInfo>
        <Services>
          <Service Code="1" />
          <Service Code="5" Included="true" />
          <Service Code="35" Included="false" />
          <Service Code="53" />
          <Service Code="54" Included="true" />
          <Service Code="61" Included="false" />
          <Service Code="79" Included="false" />
          <Service Code="202" />
          <Service Code="316" />
          <Service Code="5021" Included="false" />
          <Service Code="5025" Included="true" />
          <Service Code="173" Price="14" CurrencyCode="EUR" >
            <Types>
              <Type Code="5001" />
              <Type Code="5002" />
              <Type Code="5003" />
              <Type Code="5004" />
              <Type Code="5005" />
              <Type Code="5006" />
              <Type Code="5007" />
              <Type Code="5008" />
              <Type Code="5009" />
            </Types>
            <Items>
              <Item Code="5005"/>
              <Item Code="5006"/>
              <Item Code="5007"/>
              <Item Code="5009"/>
              <Item Code="5011"/>
            </Items>
            <OperationTimes>
              <OperationTime Mon='1' Tue='1' Weds='1' Thur='1' Fri='1' Sat='1' Sun='1' Start="08:00" End="10:00"/>
            </OperationTimes>
          </Service>
        </Services>
        <RelativePositions>
          <RelativePosition>
            <Transportations>
              <Transportation>
                <TPA_Extensions>
                  <Route>
                    <Leg>
                      <Start Type='airport' Code='AMS' />
                      <TransportType Code='5000' />
                      <Departure UponArrangement='1' />
                    </Leg>
                    <JourneyTime Minutes='20' />
                    <Price Amount='10' CurrencyCode='EUR' />
                  </Route>
                </TPA_Extensions>
              </Transportation>
            </Transportations>
          </RelativePosition>
        </RelativePositions>
      </HotelInfo>
      <FacilityInfo>
        <Restaurants>
          <Restaurant RestaurantName='Futtern wie bei Muttern' OfferBreakfast='1' OfferDinner='1'>
            <CuisineCodes>
              <CuisineCode Code='24'/>
              <CuisineCode Code='73'/>
            </CuisineCodes>
            <OperationSchedules>
              <OperationSchedule>
                <OperationTimes>
                  <OperationTime Mon='1' Tue='1' Thur='1' Fri='1' Start='16:00' End='22:00' />
                  <OperationTime Weds='1' Sun='1' Start='14:00' End='19:00' />
                </OperationTimes>
              </OperationSchedule>
            </OperationSchedules>
            <Features>
              <Feature DescriptiveText='a la carte'/>
              <Feature DescriptiveText='buffet'/>
              <Feature DescriptiveText='guests only'/>
              <Feature DescriptiveText='accepts reservations'/>
              <Feature DescriptiveText='outdoor seating'/>
            </Features>
            <TPA_Extensions>
              <Ambiances>
                <Ambiance Name='modern'/>
              </Ambiances>
              <DietaryOptions>
                <DietaryOption Name='halal'/>
                <DietaryOption Name='vegan'/>
              </DietaryOptions>
            </TPA_Extensions>
          </Restaurant>
        </Restaurants>
      </FacilityInfo>
    </HotelDescriptiveContent>
  </HotelDescriptiveContents>
</OTA_HotelDescriptiveContentNotifRQ>

Response

The response contains an OTA_HotelDescriptiveContentNotifRS object:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelDescriptiveContentNotifRS 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_HotelDescriptiveContentNotifRS.xsd" TimeStamp="2015-07-31T12:36:23-00:00" Target="Production" Version="3.000">
<Success />
</OTA_HotelDescriptiveContentNotifRS>
<!-- RUID: [UmFuZG9etc] -->