> 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/direct-connect-demand-push/interface-specifications-ari-service/operation-property-list/hotelpropertylistgetrs.md).

# HotelPropertyListGetRS

* **HotelPropertyListGetRS**:
  * OTA should respond to the `HotelPropertyListGetRQ` request by returning a `HotelPropertyListGetRS` message.

**Validation and Errors**:

* If the OTA is not able to validate a message at the application level, it should still return a `HotelPropertyListGetRS` message.
* **Failure Response**: Response messages indicating failures must contain at least one error element. More than one error element can be returned if necessary.

**Successful Response**:

* After validating the chain code or login credentials, the OTA should:
  * Return a `HotelPropertyListGetRS` message with a single Success element.
  * Include the list of properties in the Hotels element.
* **Single Property Account**:
  * If the OTA does not use multi-property accounts, it should return information regarding the one hotel identified by the request.

| <p><strong>Element/@Attribute</strong></p><p><strong>Parent Xpath</strong>  </p> | <p>  </p><p><strong>Description</strong> </p>                                                                                                                                                                                                                               | **Mandatory**                                |
| -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| <p>@TimeStamp </p><p> <strong>/HotelPropertyListGetRS</strong>  </p>             | Time of the transaction in XML schema date-time format.                                                                                                                                                                                                                     | Y                                            |
| <p>@Target </p><p> <strong>/HotelPropertyListGetRS</strong>  </p>                | <p>  </p><p>The environment to target this message to. For this version of the specification always set to “Production”. </p>                                                                                                                                               | <p>          Y </p><p><br></p>               |
| <p>@Version </p><p><strong>/HotelPropertyListGetRS</strong>  </p>                | The version of the message. For this version of the specification set to “1.0”.                                                                                                                                                                                             | <p>           Y </p><p><br></p>              |
| <p>Success </p><p><strong>/HotelPropertyListGetRS</strong></p>                   | <p>If included, this element will indicate that the request message was successfully processed. </p><p>If this element is returned, a hotel element must also be returned. Either a Success element or an Errors element is required in every response. </p>                | <p><br></p><p>            Y? </p>            |
| <p>Errors </p><p> <strong>/HotelPropertyListGetRS</strong> </p>                  | <p>If included, this element will indicate that the request message could not be processed. </p><p>Either a Success element or an Errors element is required in every response.</p>                                                                                         | <p>             Y? </p><p><br></p>           |
| <p>Error </p><p><strong>/HotelPropertyListGetRS/Errors</strong> </p>             | <p>Description of cause for a fatal problem during request message processing. </p><p>\*If an Errors element is included, at least one Error element is required. </p>                                                                                                      | <p><br></p><p>             Y </p><p><br></p> |
| <p>@Type </p><p><strong>/HotelPropertyListGetRS/Errors/Error</strong></p>        | <p>  </p><p>This is an enumeration of error types. See Code Lists below for supported values. Code list Error Types. </p>                                                                                                                                                   | Y                                            |
| <p>@Code</p><p><strong>/HotelPropertyListGetRS/Errors/Error</strong></p>         | This is an enumeration of error codes. See Code Lists below for supported values. Code list Error Codes.                                                                                                                                                                    | <p>             Y </p><p><br></p>            |
| <p>Hotels </p><p><strong>/HotelPropertyListGetRS</strong>  </p>                  | This element contains a list of hotels. This element is used to return the list of all hotels that belong to the chain that can be updated using these login credentials.                                                                                                   | Y?                                           |
| <p>@ChainCode </p><p><strong>/HotelPropertyListGetRS/Hotels</strong>  </p>       | <p>The code identifies the hotel chain. All the hotels returned belong to this chain of hotels. This code is assigned by the  OTA. </p><p>If you don’t support this Code then a blank value will be passed in this attribute of the request. </p>                           | N                                            |
| <p>Hotel </p><p><strong>/HotelPropertyListGetRS/Hotels</strong>  </p>            | <p>  </p><p>This element contains information about one hotel. </p>                                                                                                                                                                                                         | Y                                            |
| <p>@HotelCode </p><p><strong>/HotelPropertyListGetRS/Hotels/Hotel</strong></p>   | <p>This element identifies the hotel. The OTA must assign a code that identifies the hotel across all chains of hotels. The chain code is not passed in other transactions. Therefore the code must uniquely identify the hotel independent of the chain code. </p><p> </p> | Y                                            |
| <p>@Name </p><p><strong>/HotelPropertyListGetRS/Hotels/Hotel</strong></p>        | <p>The name of the hotel. </p><p> </p>                                                                                                                                                                                                                                      | Y                                            |


---

# 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, and the optional `goal` query parameter:

```
GET https://developer.rategain.com/our-products/channel-manager/direct-connect-demand-push/interface-specifications-ari-service/operation-property-list/hotelpropertylistgetrs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.