Property Financials

Overview

The Update listing Financials API describes the default and basic financial settings you can apply to your property after creating it. These settings represent a basic strategy and are explained here in brief.

You can achieve more dynamic pricing through Guesty's Revenue Management and Price Optimizer products or Markeplace Partner pricing tools.

Base Price

The basePrice is the simplest method for managing nightly base rates. It allows you to assign a flat rate across all dates with an option for weekend pricing (weekendBasePrice). You can also set the base price in US Dollars (basePriceUSD for channels whose transactions are only in USD.

The calendar API allows you to set the nightly rate per date for more dynamic pricing. Calendar pricing supersedes the base price. Third-party pricing tools and Guesty's Revenue Management features apply pricing to the calendar.

Length of Stay Discounts

Monthly (monthlyPriceFactor) and weekly (weeklyPriceFactor) Discounts can be configured and applied to the base price or nightly rate. They are written as a fraction representing the full price less the discount. For example, a five percent discount is passed as 0.95.

Extra Person Fee

You can limit the number of guests that are included in the price of a reservation (guestsIncludedInRegularFee) and charge extra guest fees (extraPersonFee) for those reservations that exceed the total number. Learn more about this in Guesty's Help Center.

Security Deposit

Set a security deposit amount (securityDepositFee). For more information, see Guesty's Help Center.

Currency

To receive reservations at the property, you must set a currency. Once set, the nightly rates and reservation financials will display the fees in this currency. Changing the currency won't affect existing reservations, only new ones created after the change.

Cleaning Fee

Guesty permits you to apply a default cleaning fee to all channels or to create variants in addition to the default for the following supported booking channels via the API (more option may be available in the user dashboard):

📘

Note

You can only set the channel cleaning fee if the property is connected with the booking channel.

The cleaning fee can be a fixed amount or percentage-based and calculated: PER_STAY, PER_GUEST, PER_NIGHT, or PER_GUEST_PER_NIGHT.