> 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/ultradirect/ultradirect-transaction-samples-and-usage/rate-rules.md).

# Rate Rules

This transaction set is used to request additional policy information for a specific rate and room type combination that is not included in the availability response. All hotel CRSs support this transaction, however, each CRS operates differently and may or may not include all optional fields.

#### Example Rate rules request: <a href="#raterules..-exampleraterulesrequest" id="raterules..-exampleraterulesrequest"></a>

```xml
<HotelML xmlns="
http://www.xpegs.com/v2001Q3/HotelML
">
<Head>
<Process DataPath="/HotelML/Form/PropertyInformation" Function="TI_PropertyInformationV1_1" Token="1311082860417"/>
<Route Destination="00" Source="XX"/>
</Head>
<Form>
<PropertyInformation PropertyCode="HY;998">
<PropertyRate NumberOfAdults="2" NumberOfChildren="1" NumberOfRooms="1">
<AgentInfo Number="XXXXXXXX" Type="TIDS"/>
<RatePlan Code="RACK" InDate="2013-10-10" OutDate="2013-10-11">
<RoomType Code="KNG"/>
</RatePlan>
</PropertyRate>
</PropertyInformation>
</Form>
</HotelML>

```

* This request should NOT be used to check availability.
* There is a maximum of 1 PropertyInformation element (brand;pid) that can be included in each request.
* Rate Rule requests are used if more detailed information on the rate is required or if rate change details are required and not returned in the EST response.
* This request is mandatory for public/commissionable rates.

#### Example Rate Rules response: <a href="#raterules..-exampleraterulesresponse" id="raterules..-exampleraterulesresponse"></a>

```xml
<HotelML xmlns="
http://www.xpegs.com/v2001Q3/HotelML
">
<Head>
<Route Destination="XX" Source="00">
<Operation Action="Create" App="TIDispatcher" AppVer="1.12.40.2.8.1.20.4.2.7.12.1.12.2.2.1.8.1.2.11" DataPath="/HotelML" StartTime="2013-02-18T15:05:42.934+00:00" Success="true" TotalProcessTime="3029"/>
</Route>
</Head>
<Property xml:lang="en" Code="HY;998" Token="1311082860417">
<Rate>
<RatePlan Code="RACK" CommissionableStatus="Commissionable" Description="HYATT DAILY RATE Regularly published room rates." InDate="2013-10-10" MarketingText1="WELCOME TO HYATT" OutDate="2013-10-11" TaxInformation="TAX: 15.000 PERCENT">
<RoomType BookableRate="499.00" Code="KNG" NativeCurrency="USD" RateFrequency="Daily" RoomDescription="1 KING BED 1 King pillow-top Grand bed:iHome Stereo 350 sq ft:Dataport" TotalRate="499.00" TotalRateInclusive="575.15" TaxQualifier="NonInclusive">
<CommissionPolicy Description="10.000 PERCENT COMMISSION"/>
<GuaranteePolicy Description="CREDIT CARD GUARANTEE REQUIRED"/>
<CancelPolicy Description="CANCEL BY 3PM CST 24 HOURS PRIOR TO ARRIVAL"/>
<TaxDetail Amount="2.00" Application="PerRoomPerNight" Basis="Independent" EffectiveStartDate="2013-10-10" EffectiveEndDate="2013-10-11" Order="1" Type="Miscellaneous" Unit="Percent" Inclusive="no"/>
<TaxDetail Amount="13.00" Application="PerRoomPerNight" Basis="Compound" EffectiveStartDate="2013-10-10" EffectiveEndDate="2013-10-11" Order="2" Type="StateTax" Unit="Percent" Inclusive="no"/>
</RoomType>
</RatePlan>
</Rate>
</Property>
</HotelML>

```

* All relevant textual policies will need to be displayed for public rates but may not be needed for negotiated rates.
* Except TaxDetail information, most policy information returned in the Rate Rules response is unstructured free-form description rather than structured coded and formatted responses.
* Confirm availability by running an enhanced shopping request using RequestedAccuracy=SourceOnly between rate rules and book reservations.

<br>

<br>


---

# 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/ultradirect/ultradirect-transaction-samples-and-usage/rate-rules.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.
