# Affiliation information

Although OpenTravel allows unlimited occurrences of each element within the OTA\_HotelDescriptiveContentNotifRQ message, Enterprise Connectivity has elected to set limits for many of these elements. Unless specified under the Usage column below, ENTERPRISE CONNECTIVITY only allows one instance of each element per property message.

| **Element**     | **Level** | **Attribute** | <p><strong>R</strong></p><p><strong>O</strong></p><p><strong>C</strong></p> | <p><strong>G</strong></p><p><strong>D</strong></p><p><strong>S</strong></p> | **Example** | **Usage**   | **Description**                                                                                         |
| --------------- | --------- | ------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- | ----------- | ----------- | ------------------------------------------------------------------------------------------------------- |
| AffiliationInfo | 3         | <p><br></p>   | O                                                                           | <p><br></p>                                                                 | <p><br></p> | <p><br></p> | Only 1 element allowed per Property message.                                                            |
| Awards          | 4         | <p><br></p>   | C                                                                           | <p><br></p>                                                                 | <p><br></p> | <p><br></p> | <p>Required when</p><p>AffiliationInfo element is present and LoyalPrograms element is not present.</p> |

| **Element**   | **Level**   | **Attribute** | <p><strong>R</strong></p><p><strong>O</strong></p><p><strong>C</strong></p> | <p><strong>G</strong></p><p><strong>D</strong></p><p><strong>S</strong></p> | **Example**                                   | **Usage**                                       | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ------------- | ----------- | ------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><br></p>   | <p><br></p> | <p><br></p>   | <p><br></p>                                                                 | <p><br></p>                                                                 | <p><br></p>                                   | <p><br></p>                                     | <p><br></p><p>Only 1 element allowed per Property message.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Award         | 5           | <p><br></p>   | R                                                                           | <p><br></p>                                                                 | <p><br></p>                                   | <p><br></p>                                     | Required when Awards element is present.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| <p><br></p>   | <p><br></p> | Removal       | O                                                                           | <p><br></p>                                                                 | <p><br></p>                                   | true false                                      | If not specified, false is assumed.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| <p><br></p>   | <p><br></p> | Date          | O                                                                           | <p><br></p>                                                                 | 2004-10-15                                    | Date                                            | Reflect the date the award was given.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><br></p>   | <p><br></p> | Provider      | R                                                                           | <p><br></p>                                                                 | <p>Dallas</p><p>Chamber of</p><p>Commerce</p> | <p>100 Char</p><p><br></p><p>Max: 200 bytes</p> | <p>Name of provider who gave award.</p><p><br></p><p>Required for Award element.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| <p><br></p>   | <p><br></p> | Rating        | C                                                                           | <p><br></p>                                                                 | 4 Stars                                       | <p>100 Char</p><p><br></p><p>Max: 200 bytes</p> | <p>Hotel rating.</p><p>Example: “3 Stars – Star</p><p>Magazine, 2 Circles - Circle</p><p>Magazine”</p><p><br></p><p>Note: Input of the</p><p>American Auto Association (AAA) trademarks and references to diamond ratings is prohibited by AAA. If found an error will be returned.</p><p><br></p><p>Only Required when action code is add or Overwrite = true</p><p><br></p><p>Only 1 rating per provider attribute allowed. If more than one is present, an error will be returned.</p><p><br></p><p>Rating is a multi-lingual attribute.</p> |
| LoyalPrograms | 4           | <p><br></p>   | C                                                                           | <p><br></p>                                                                 | <p><br></p>                                   | <p><br></p>                                     | <p>Required when</p><p>AffiliationInfo element is present and Awards element is not present.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| LoyalProgram  | 5           | <p><br></p>   | R                                                                           | <p><br></p>                                                                 | <p><br></p>                                   | <p><br></p>                                     | Can repeat more than once if the property participates in more than one program (but the ProgramName must be unique).                                                                                                                                                                                                                                                                                                                                                                                                                           |
| <p><br></p>   | <p><br></p> | ProgramName   | O                                                                           | <p><br></p>                                                                 | <p><br></p>                                   | <p>64 Char</p><p>Max 128 bytes</p>              | Loyal programs name, e.g. “La Quinta Returns”                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| <p><br></p>   | <p><br></p> | HotelLevel    | O                                                                           | <p><br></p>                                                                 | <p><br></p>                                   | <p>16 Char</p><p>Max 32 bytes</p>               | <p>The level/tier that the hotel participates in the loyalty program. This may affect the number of ‘points’ received for a stay or the number of points required to redeem free nights.</p><p>Examples:</p><p>B” (level B)</p><p>“2” (Level 2)</p><p>“Tier 2” </p>                                                                                                                                                                                                                                                                             |

**Schema design view**

<figure><img src="/files/INLUj8Guv3oFEzyxpNqz" alt=""><figcaption></figcaption></figure>

**Example transaction**

```xml
<OTA_HotelDescriptiveContentNotifRQ xmlns="
http://www.opentravel.org/OTA/2003/05
" xmlns:xsi="
http://www.w3.org/2001/XMLSchema-instance
" Version="4.000" PrimaryLangID="EN">
<HotelDescriptiveContents>
<HotelDescriptiveContent UnitofMeasureCode="1" CurrencyCode="USD" TimeZone="CST" BrandCode="ZZ"
HotelCode="AA123" HotelName="Test Hotel" Overwrite="false">
<AffiliationInfo>
<Awards>
<Award Removal="false" Date="2005-08-13" Provider="OTA" Rating="5 Stars"/> </Awards>
<Descriptions>
<Description>
<Text>Description text</Text>
</Description> </Descriptions> </AffiliationInfo>
</HotelDescriptiveContent>
</HotelDescriptiveContents>
</OTA_HotelDescriptiveContentNotifRQ>
```


---

# 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/content/content-update-1/transaction-specifications/affiliation-information.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.
