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