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

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