See our Lodging Rate Fees, Discounts & Taxes support article for more information on the elements in the XML below. You can see a live example on listing orp5b348ax using the sandbox in our stage environment.
cURL example:
curl --user ${ownerrez_user}:${ownerrez_key} --location --request GET "${lodgingRateContentUrl}" --silent | xmllint --format -
Get the lodgingRateContentUrl for lodging rate from the advertiser lodging rate feed.
When showing the rate breakdown, ensure you accurately present the security deposit. In OwnerRez, the PM can choose no security deposit, a refundable security deposit, or a security deposit hold.
- If it's a hold, we pass it in lodgingStayCollectedFeeSchedule.refundableDamageDepositFlat
- If it's a refundable security deposit, we pass it in fees.flatRefundableDamageDepositFees
XML payload:
<lodgingRateContent>
<listingExternalId>orp5b348ax</listingExternalId>
<unitExternalId>orp5b348ax</unitExternalId>
<lodgingRate>
<currency>USD</currency>
<discounts>
<flatAmountDiscounts>
<discount>
<externalId>ORSUR102514113</externalId>
<name>Test Discount 1</name>
<amount>5.0000</amount>
<appliesPerStay/>
</discount>
</flatAmountDiscounts>
<percentOfRentDiscounts>
<discount>
<externalId>ORSUR102514115</externalId>
<name>Test Discount 2</name>
<appliesPerNight/>
<percent>1.0000</percent>
</discount>
</percentOfRentDiscounts>
</discounts>
<externalUpdateDate>2024-01-22T19:10:25</externalUpdateDate>
<fees>
<cleaningFees>
<fee>
<displayInRent>false</displayInRent>
<externalId>ORSUR102514111</externalId>
<amount>125.0000</amount>
<appliesPerStay>
<forStaysOfNights>
<range>
<max>11</max>
<min>7</min>
</range>
</forStaysOfNights>
<whenStayDatesIntersect>
<range>
<max>2025-12-31</max>
<min>2025-01-01</min>
</range>
</whenStayDatesIntersect>
</appliesPerStay>
</fee>
</cleaningFees>
<flatRefundableDamageDepositFees>
<fee>
<externalId>ORSUR102514105</externalId>
<amount>100.0000</amount>
<appliesPerStay/>
</fee>
</flatRefundableDamageDepositFees>
<guestFees>
<fee>
<displayInRent>false</displayInRent>
<externalId>ORSUR102514110</externalId>
<amount>40.0000</amount>
<appliesPerGuestPerStay>
<forGuestNumber>
<range>
<max>12</max>
<min>4</min>
</range>
</forGuestNumber>
</appliesPerGuestPerStay>
</fee>
<fee>
<displayInRent>false</displayInRent>
<externalId>ORSUR102514117</externalId>
<amount>8.0000</amount>
<appliesPerGuestPerNight>
<forGuestNumber>
<range>
<max>12</max>
<min>2</min>
</range>
</forGuestNumber>
<forGuestsOfAge>
<range>
<min>8</min>
</range>
</forGuestsOfAge>
</appliesPerGuestPerNight>
</fee>
</guestFees>
<otherFees>
<fee>
<displayInRent>false</displayInRent>
<externalId>ORSUR102514112</externalId>
<amount>15.0000</amount>
<appliesPerNight>
<forNightsBookedInAdvance>
<range>
<max>9</max>
<min>8</min>
</range>
</forNightsBookedInAdvance>
<forStaysWithNumberOfGuests>
<range>
<max>11</max>
<min>6</min>
</range>
</forStaysWithNumberOfGuests>
<whenBookingDateIn>
<range>
<max>2024-12-31</max>
<min>2024-01-01</min>
</range>
</whenBookingDateIn>
<whenCheckinDateIn>
<range>
<max>2025-12-31</max>
<min>2025-01-01</min>
</range>
</whenCheckinDateIn>
<whenStayDateIn>
<range>
<max>2025-12-31</max>
<min>2025-01-01</min>
</range>
</whenStayDateIn>
</appliesPerNight>
<name>Parking Fee</name>
<productCode>PARKING</productCode>
</fee>
</otherFees>
<percentOfRentFees>
<fee>
<displayInRent>false</displayInRent>
<externalId>ORSUR102514107</externalId>
<percent>1.0000</percent>
<appliesPerNight/>
<name>Management</name>
<productCode>MANAGEMENT</productCode>
</fee>
</percentOfRentFees>
<percentOfRentRefundableDamageDepositFees>
<fee>
<externalId>ORSUR102514106</externalId>
<percent>2.0000</percent>
<appliesPerStay/>
</fee>
</percentOfRentRefundableDamageDepositFees>
<percentOfSubtotalFees>
<fee>
<displayInRent>false</displayInRent>
<externalId>ORSUR102514108</externalId>
<appliesToSubtotalPerStay>
<whenProductCodeIn>
<code>DEPOSIT_DAMAGE</code>
<code>PET</code>
<code>GUEST</code>
<code>CLEANING</code>
<code>PARKING</code>
<code>MANAGEMENT</code>
</whenProductCodeIn>
</appliesToSubtotalPerStay>
<name>Resort Fee</name>
<percent>2.0000</percent>
<productCode>RESORT</productCode>
<subtotalIncludesRentAndDiscounts>true</subtotalIncludesRentAndDiscounts>
</fee>
</percentOfSubtotalFees>
<petFees>
<fee>
<displayInRent>false</displayInRent>
<externalId>ORSUR102514109</externalId>
<amount>10.0000</amount>
<appliesPerPetPerStay>
<forPetNumber>
<range>
<min>1</min>
</range>
</forPetNumber>
</appliesPerPetPerStay>
</fee>
<fee>
<displayInRent>false</displayInRent>
<externalId>ORSUR102514116</externalId>
<amount>12.0000</amount>
<appliesPerPetPerNight>
<forPetNumber>
<range>
<min>1</min>
</range>
</forPetNumber>
</appliesPerPetPerNight>
</fee>
</petFees>
</fees>
<language>en</language>
<nightlyRates>
<fri>350.00</fri>
<mon>350.00</mon>
<nightlyOverrides>
<override>
<amount>275.00</amount>
<nights>
<range>
<max>2024-01-25</max>
<min>2024-01-23</min>
</range>
<range>
<max>2024-02-01</max>
<min>2024-01-28</min>
</range>
<range>
<max>2024-02-08</max>
<min>2024-02-04</min>
</range>
<range>
<max>2024-02-15</max>
<min>2024-02-11</min>
</range>
<range>
<max>2024-02-22</max>
<min>2024-02-18</min>
</range>
<range>
<max>2024-02-29</max>
<min>2024-02-25</min>
</range>
<range>
<max>2024-03-07</max>
<min>2024-03-03</min>
</range>
<range>
<max>2024-03-14</max>
<min>2024-03-10</min>
</range>
<range>
<max>2024-03-21</max>
<min>2024-03-17</min>
</range>
<range>
<max>2024-03-28</max>
<min>2024-03-24</min>
</range>
<range>
<max>2024-04-04</max>
<min>2024-03-31</min>
</range>
<range>
<max>2024-04-11</max>
<min>2024-04-07</min>
</range>
<range>
<max>2024-04-18</max>
<min>2024-04-14</min>
</range>
<range>
<max>2024-04-25</max>
<min>2024-04-21</min>
</range>
<range>
<max>2024-05-02</max>
<min>2024-04-28</min>
</range>
<range>
<max>2024-05-09</max>
<min>2024-05-05</min>
</range>
<range>
<max>2024-05-16</max>
<min>2024-05-12</min>
</range>
<range>
<max>2024-05-23</max>
<min>2024-05-19</min>
</range>
<range>
<max>2024-05-30</max>
<min>2024-05-26</min>
</range>
<range>
<max>2024-06-06</max>
<min>2024-06-02</min>
</range>
<range>
<max>2024-06-13</max>
<min>2024-06-09</min>
</range>
<range>
<max>2024-06-20</max>
<min>2024-06-16</min>
</range>
<range>
<max>2024-06-27</max>
<min>2024-06-23</min>
</range>
<range>
<max>2024-07-04</max>
<min>2024-06-30</min>
</range>
<range>
<max>2024-07-11</max>
<min>2024-07-07</min>
</range>
<range>
<max>2024-07-18</max>
<min>2024-07-14</min>
</range>
<range>
<max>2024-07-25</max>
<min>2024-07-21</min>
</range>
<range>
<max>2024-08-01</max>
<min>2024-07-28</min>
</range>
<range>
<max>2024-08-08</max>
<min>2024-08-04</min>
</range>
<range>
<max>2024-08-15</max>
<min>2024-08-11</min>
</range>
<range>
<max>2024-08-22</max>
<min>2024-08-18</min>
</range>
<range>
<max>2024-08-29</max>
<min>2024-08-25</min>
</range>
<range>
<max>2024-09-05</max>
<min>2024-09-01</min>
</range>
<range>
<max>2024-09-12</max>
<min>2024-09-08</min>
</range>
<range>
<max>2024-09-19</max>
<min>2024-09-15</min>
</range>
<range>
<max>2024-09-26</max>
<min>2024-09-22</min>
</range>
<range>
<max>2024-10-03</max>
<min>2024-09-29</min>
</range>
<range>
<max>2024-10-10</max>
<min>2024-10-06</min>
</range>
<range>
<max>2024-10-17</max>
<min>2024-10-13</min>
</range>
<range>
<max>2024-10-24</max>
<min>2024-10-20</min>
</range>
<range>
<max>2024-10-31</max>
<min>2024-10-27</min>
</range>
<range>
<max>2024-11-07</max>
<min>2024-11-03</min>
</range>
<range>
<max>2024-11-14</max>
<min>2024-11-10</min>
</range>
<range>
<max>2024-11-21</max>
<min>2024-11-17</min>
</range>
<range>
<max>2024-11-28</max>
<min>2024-11-24</min>
</range>
<range>
<max>2024-12-05</max>
<min>2024-12-01</min>
</range>
<range>
<max>2024-12-12</max>
<min>2024-12-08</min>
</range>
<range>
<max>2024-12-19</max>
<min>2024-12-15</min>
</range>
<range>
<max>2024-12-26</max>
<min>2024-12-22</min>
</range>
<range>
<max>2024-12-30</max>
<min>2024-12-29</min>
</range>
<range>
<max>2025-01-02</max>
<min>2025-01-01</min>
</range>
<range>
<max>2025-01-09</max>
<min>2025-01-05</min>
</range>
<range>
<max>2025-01-16</max>
<min>2025-01-12</min>
</range>
<range>
<max>2025-01-21</max>
<min>2025-01-19</min>
</range>
</nights>
</override>
<override>
<amount>100.00</amount>
<nights>
<range>
<max>2024-12-31</max>
<min>2024-12-31</min>
</range>
</nights>
</override>
</nightlyOverrides>
<sat>350.00</sat>
<sun>350.00</sun>
<thu>350.00</thu>
<tue>350.00</tue>
<wed>350.00</wed>
</nightlyRates>
<paymentSchedule>
<payments>
<payment>
<dueType>AT_BOOKING</dueType>
<requiresPercentOfTotalBooking>
<percent>50.0000</percent>
</requiresPercentOfTotalBooking>
</payment>
<payment>
<days>30</days>
<dueType>BEFORE_CHECKIN</dueType>
<requiresRemainder/>
</payment>
</payments>
</paymentSchedule>
<taxRules>
<!-- Note: the tax rules below are mutually exclusive -->
<percentOfRentTaxRules>
<rule>
<activeLocalDateRange>
<min>2024-01-22</min>
</activeLocalDateRange>
<currency>USD</currency>
<externalId>ORTAX1519</externalId>
<name>test</name>
<percent>2.0000</percent>
<appliesPerStay/>
</rule>
</percentOfRentTaxRules>
<percentOfRentAndFeesTaxRules>
<rule>
<activeLocalDateRange>
<min>2024-01-22</min>
</activeLocalDateRange>
<currency>USD</currency>
<externalId>ORTAX1520</externalId>
<name>Test Tax 1</name>
<appliesToRentAndFeesPerStay>
<whenProductCodeIn>
<code>RENT</code>
<code>PET</code>
<code>GUEST</code>
<code>CLEANING</code>
<code>PARKING</code>
<code>MANAGEMENT</code>
<code>RESORT</code>
</whenProductCodeIn>
</appliesToRentAndFeesPerStay>
<percent>8.0000</percent>
</rule>
</percentOfRentAndFeesTaxRules>
<percentOfFeesTaxRules>
<rule>
<activeLocalDateRange>
<min>2024-01-22</min>
</activeLocalDateRange>
<currency>USD</currency>
<externalId>ORTAX1521</externalId>
<name>Test Tax 1</name>
<appliesToFeesPerStay>
<whenProductCodeIn>
<code>RENT</code>
<code>PET</code>
<code>GUEST</code>
<code>CLEANING</code>
<code>PARKING</code>
<code>MANAGEMENT</code>
<code>RESORT</code>
</whenProductCodeIn>
</appliesToFeesPerStay>
<percent>8.0000</percent>
</rule>
</percentOfFeesTaxRules>
</taxRules>
</lodgingRate>
</lodgingRateContent>