> For the complete documentation index, see [llms.txt](https://developer.rategain.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.rategain.com/our-products/channel-manager/rg-bridge-supply-push/interface-specifications-availability-and-rates-notification-service/operations/availability-notification/ota_hotelavailnotifrq/change-in-availability-status-and-restrictions.md).

# Change in availability status and Restrictions

**Requirements**:

* **RoomType and RatePlan Information**: Any change in availability status or restrictions must include both `RoomType` and `RatePlan` information.
* **Availability Updates**: The PMS must send availability updates at the room type level.
* **Availability Status and Restrictions Updates**: These updates should be sent at the product level, which is a combination of `RoomType` and `RatePlan`.

**Handling Multiple Products**:

* If multiple products are associated with a single room type, and the availability notification message does not specify a rate type, the update will be applied to all rate types associated with that room type.

```xml
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"  
TimeStamp="2004-05-01T06:39:09" 
 
Target="Production" 
 
Version="1.002" EchoToken="25525379hyyds63" 
 
 <AvailStatusMessages HotelCode="ATLPE" HotelName="The Sheraton"> 
 
 <AvailStatusMessage> 
 
 	<StatusApplicationControl Start="2011-12-02" End="2011-12-05" 
 
 InvCode="STD" RatePlanCode="BAR"> </StatusApplicationControl> 
 
<RestrictionStatus Status="Open"/> 
 
 	<UniqueID Type="16" ID="1"/> 
 
 </AvailStatusMessage> 
 
 <AvailStatusMessage> 
 
 	<StatusApplicationControl Start="2011-12-02" End="2011-12-05" 
 
 InvCode="STD" RatePlanCode="BAR"> </StatusApplicationControl> 
 
<LengthsOfStay> 
 
<<LengthOfStay MinMaxMessageType="SetMinLOS" 
TimeUnit="Day" Time="1"/></LengthOfStay> 
 	</LengthsOfStay> 
 
 	<UniqueID Type="16" ID="2"/> 
 
 </AvailStatusMessage> 
 
 <AvailStatusMessage> 
 
 	<StatusApplicationControl Start="2011-12-02" End="2011-12-05" 
 
 InvCode="STD" RatePlanCode="BAR"> </StatusApplicationControl> 
 
<LengthsOfStay> 
 
<<LengthOfStay MinMaxMessageType="SetMaxLOS" 
TimeUnit="Day" Time="10"/></LengthOfStay> 
 	</LengthsOfStay> 
 
 	<UniqueID Type="16" ID="3"/> 
 
 </AvailStatusMessage> 
 
</AvailStatusMessages> 
</OTA_HotelAvailNotifRQ> 

```

**Availability request XML sample**

| <p><strong>Element/@Attribute</strong></p><p> </p><p><strong>Parent XPath</strong></p>                                                                                                                                                                                                                 | <p> </p><p><strong>Description</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | **Occurrences**             |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| <p>@TimeStamp</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                                       | <p> </p><p>Time of the transaction in xml schema date-time format</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | 1                           |
| <p>@EchoToken</p><p>  </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                                              | Unique Identifier to track the RQ/RS message                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                           |
| <p>@Target</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                                          | <p> </p><p>Always set to “Production”</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                           |
| <p>@Version</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                                         | <p> </p><p>Always set to “1.0”</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 1                           |
| <p>AvailStatusMessages</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ</strong></p>                                                                                                                                                                                                              | <p> </p><p>Contains list of availability messages (AvailStatusMessage)</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                           |
| <p>@HotelCode</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages</strong></p>                                                                                                                                                                                                   | <p> </p><p>The code of the property whose availability is being updated</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 1                           |
| <p>@HotelName</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages</strong></p>                                                                                                                                                                                                   | <p> </p><p>The name of the property whose availability is being updated</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | 0..1                        |
| <p>AvailStatusMessage</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages</strong></p>                                                                                                                                                                                           | An availability message. One of the BookingLimit or RestrictionStatus or LengthsOfStay must be included                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 1..n                        |
| <p>@BookingLimit</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                                             | <p> </p><p>The number of rooms available.</p><p>Optional,tobeset atRoom level</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 0…1                         |
| <p>@BookingLimitMessageType</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                                  | <p>Always set to “SetLimit”.</p><p>Mandatory if “BookingLimit” is available.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 0…1                         |
| <p> </p><p>StatusApplicationControl</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                          | <p>The date range, room type code and rate code for which this</p><p>notification is sent is specified in this element</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                           |
| <p>@Start</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>StatusApplicationControl</strong></p>                                                                                                                                   | <p> </p><p>The start date for which the availability update is being set</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 1                           |
| <p>@End</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>StatusApplicationControl</strong></p>                                                                                                                                     | <p> </p><p>The end date for which the availability update is being set</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                           |
| <p> </p><p>@InvCode</p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>StatusApplicationControl</strong></p>                                                                                                                         | <p>Identifies the room type for which the availability is being updated. The room type code + rate code</p><p>identify a unique product for which this update applies.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 1                           |
| @RatePlanCode                                                                                                                                                                                                                                                                                          | <p>Identifies the rate plan for which the availability is being updated.</p><p>Optional, in case of Inventory count (“BookingLimit”) only.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 0..1                        |
| <p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>StatusApplicationControl</strong></p>                                                                                                                                                                | <p><br></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | <p><br></p>                 |
| <p> @Mon<br>@ Tue<br><br>@Weds<br>@Thur<br>@Fri<br>@Sat<br>@Sun<br><br>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/<br>StatusApplicationControl<br><br></p>                                                                                                                         | <p>The day of the week indicators are used to communicate which days of the week the update pertains to.<br>For example, if Mon, Tue and Weds are set to "1", and the other days are set to "0", the availability will<br>only be updated for Mondays, Tuesdays and Wednesdays. Optional.</p><p>If not set, all are assumed to be set to true.<br><br>NOTE: If one is sent they must all be sent.</p>                                                                                                                                                                                                                             | 0..1                        |
| <p>UniqueID<br>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</p>                                                                                                                                                                                                                      | <p> </p><p>Unique identifier for each availability message</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | 1                           |
| <p>LengthsOfStay</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                                     | <p>Availability based on length of stay can be set using this.</p><p><br></p><p>Optional</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 0..1                        |
| <p>LengthOfStay</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p><p> </p><p><strong>/LengthsOfStay</strong></p>                                                                                                                        | <p> </p><p>Mandatory if LengthsOfStay present.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 1                           |
| <p>@Time</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p><p> </p><p><strong>/LengthsOfStay /LengthOfStay</strong></p>                                                                                                                 | <p> </p><p>Mandatory if LengthOfStay is present. Sets the minimum number of days required for a stay.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 1                           |
| <p>@TimeUnit</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p><p> </p><p><strong>/LengthsOfStay /LengthOfStay</strong></p>                                                                                                             | <p> </p><p>Mandatory if LengthOfStay is present. Always set to“Day”</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | 1                           |
| <p> </p><p> </p><p>@MinMaxMessageType</p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p><p> </p><p><strong>/LengthsOfStay /LengthOfStay</strong></p>            | <p>Mandatory if LengthOfStay is present. Stay control type. Can be any of the options below:</p><p>SetMinLOS : To set minimum length of stay.</p><p>SetMaxLOS: To set maximum length of stay.</p><p>SetForwardMinStay: To set minimum length of stay through.</p><p>SetForwardMaxStay: To set maximum length of stay through.</p>                                                                                                                                                                                                                                                                                                 | 1                           |
| <p>RestrictionStatus</p><p> </p><p> </p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage</strong></p>                                                                                                                                                                 | <p> </p><p>Availability status assigned to the room rate combination.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 0..1                        |
| <p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p> </p><p>@Status</p><p> </p><p><strong>/OTA\_HotelAvailNotifRQ/AvailStatusMessages/AvailStatusMessage/</strong></p><p><strong>RestrictionStatus</strong></p> | <p>The restriction status. Mandatory if RestrictionStatus is present. Can be any of the options below:</p><p>Open: The Sale is open.</p><p>Close: The Sale is closed.</p><p>ClosedOnArrival: Arrival is closed.</p><p>ClosedOnDeparture: Departure is closed.</p><p>OpenOnArrival: Arrival is open.</p><p>OpenOnDeparture: Departure is open.</p><p>ClosedOnArrivalDeparture: Both Arrival & Departure is closed.</p><p>MaxAdvancedBookingOffset: Maximum number of days before the arrival date the hotel is bookable.</p><p>MinAdvancedBookingOffset: Minimum number of days before the arrival date the hotel is bookable.</p> | <p>        1</p><p><br></p> |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.rategain.com/our-products/channel-manager/rg-bridge-supply-push/interface-specifications-availability-and-rates-notification-service/operations/availability-notification/ota_hotelavailnotifrq/change-in-availability-status-and-restrictions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.