Last updated

Enable long stay bookings

You can enable properties to consent to accept stays longer than 30 days and upto 90 days using the OTA_HotelDescriptiveContentNotif endpoint. By default, a property is configured to accept bookings for stays up to 30 days.

To enable properties to host stays longer than 30 days and up to a maximum of 90 days, use the LongStayInfo element:

  • Set the AcceptLongStay attribute to 1.
  • Set the maximum stay duration using the MaxLengthOfStay attribute. Allowed values are: 45, 60, 75, 90 days.

Before enabling long stays, make sure that properties follow any applicable local laws and regulations.

→ For properties located in Japan, make sure that properties show the disclaimer text as listed in the standard phrase: LongStayDisclaimerJapan.

Request body parameters

The following table describes the elements you must add in the request body when creating or updating a property to enable long stays:

ElementAttributeDescriptionTypeRequired/OptionalNotes
> OTA_HotelDescriptiveContentNotifRQRoot element.objectRequired
>> HotelDescriptiveContentsContains property details.objectRequired
>>> HotelDescriptiveContentContains property details.objectRequired
>>>> TPA_ExtensionsContains additional details like standard phrases, pricing type, long stay support and so on.objectOptional
>>>>> LongStayInfoContains long stay booking support.objectOptional
AcceptLongStaySpecify whether the property accepts bookings for stays longer than 30 nights.booleanRequiredAccepts:
- 0: false (default)
- 1: true
MaxLengthOfStaySpecify the maximum length of stay that a guest can book.intOptionalAccepts: 45, 60, 75, 90.
Defaults to 90.

Request body example

The following is an excerpted request body example that consents to long stay bookings and receives stays upto 45 days long:

<HotelDescriptiveContent
  HotelCode="12345"
  HotelDescriptiveContentNotifType="Overlay"
  HotelName="Example Hotel"
  ID="101010"
  LanguageCode="en">
    ...
  <TPA_Extensions>
    <LongStayInfo
      AcceptLongStay="1"
      MaxLengthOfStay="45"
    />
  </TPA_Extensions>
    ...
</HotelDescriptiveContent>

Response body example

The following is a successful response body example:

<?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="2022-10-11T16:27:00+00:00" Target="Test" Version="3.000">
<Success />
</OTA_HotelDescriptiveContentNotifRS>
<!-- RUID: [[XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX==]] -->

Response body parameters

The following table describes the response elements:

ElementDescriptionTypeNotes
OTA_HotelDescriptiveContentNotifRSContains the response data.object
> warningsContains potential warnings. These can help you improve your requests.array
> errorsContains potential errors. These can help you understand what went wrong with your request.array
> successIndicates the success of the request.object
ruidSpecifies the unique ID of the request.stringYou can send this ID to Booking.com Connectivity support team if you run into an issue. This can help to understand what went wrong.