Rate Push
Pushes daily pricing details for room configurations. This path requires that the physical property associated with the {propertyCode} is owned by the authenticated partner, otherwise a 403 Forbidden is returned.
POST/api/partner/property/{propertyCode}/RateAmountNotifRQ
Request schema (OTA_HotelRateAmountNotifRQ)#
| Path / node name | Type | Required | Description / constraints |
|---|---|---|---|
| POS | Object | Optional | Point of Sale element. If omitted, POS and RequestorID are automatically attached based on the property subscription. |
| @EchoToken | Attribute | Optional | A unique transaction tracker string generated by the partner. |
| RateAmountMessages/@HotelCode | Attribute | Optional | Must match the {propertyCode} in the URI. |
| StatusApplicationControl | Object | Optional | Dates and room identifiers: @Start / @End (YYYY-MM-DD range) • @InvTypeCode target room code (e.g. DBL) • @RatePlanCode target rate plan (e.g. BAR) • @Mon to @Sun (Boolean) flags defining active days |
| BaseByGuestAmt | List | Optional | Price values mapped to guests: @AmountBeforeTax / @AmountAfterTax (decimals) • @CurrencyCode ISO identifier (e.g. USD) • @NumberOfGuests threshold capacity for the pricing tier |
| AdditionalGuestAmount | List | Optional | Surcharges for extra guests: @Amount (float) • @AgeQualifyingCode age category • @MaxAge limit for child/infant definitions |
Example payload#
Day-of-week attribute spellings
The examples use Weds and Thur for Wednesday and Thursday. Copy the day-of-week attributes exactly as shown in the examples.
Example Rate Request XML
xml
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="123456" TimeStamp="2026-07-17T17:30:00Z" Version="1.0">
<POS>
<Source>
<RequestorID ID="PARTNER_A"/>
</Source>
</POS>
<RateAmountMessages HotelCode="PROP_A123">
<RateAmountMessage>
<StatusApplicationControl Start="2026-08-01" End="2026-08-10" InvTypeCode="DBL" RatePlanCode="BAR" Mon="true" Tue="true" Weds="true" Thur="true" Fri="true" Sat="true" Sun="true"/>
<Rates>
<Rate>
<BaseByGuestAmts>
<BaseByGuestAmt AmountBeforeTax="150.00" AmountAfterTax="172.50" CurrencyCode="USD" NumberOfGuests="2"/>
</BaseByGuestAmts>
<AdditionalGuestAmounts>
<AdditionalGuestAmount Amount="30.0" AgeQualifyingCode="10" MaxAge="12"/>
</AdditionalGuestAmounts>
</Rate>
</Rates>
</RateAmountMessage>
</RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>