[Beta] Basic Fees5

Account Brands1

Accounting (only available for accounting add-on users)15

Accounts6

AdditionalFees8

Address4

Airbnb Listing Expectations2

Airbnb Resolution Center1

Amenities4

Calendar5

Calendar Logs1

Calendar Sync (iCal export)5

Calendar Sync (iCal import)7

Channel Commission15

Complexes7

Custom Fields4

Expenses (only available for accounting add-on users)6

Group Reservations Open Api [Beta]2

Groups [Pilot]5

Guest app1

Guest Folio3

Guests6

Guesty Locks Manager1

House Rules4

Inbox Conversations5

Integrations4

Invoice Items1

Listing external links5

Listings17

Marketing fields12

Open Api Ari Calendar v12

Open Api Rate Plan CRUD v19

Owner Statements (only available for accounting add-on users)1

Owners7

Owners Documents6

Owners Reservations3

Ownerships3

Payment Methods3

Payment providers6

Payment Transactions2

Payouts4

Phone Book Entries5

Pre-approve inquiry1

Price Adjustments3

Promotions Open Api4

Properties Logs1

Property Media4

Property Photos6

Quotes Open Api [Beta]4

RateStrategyOpenApi2

Recorded Payments4

Reservation Payments9

Reservations18

Reservations Open Api [Beta]29

Reservations Reports Open Api [Beta]1

Review7

Roles3

Room Photos4

Saved Replies6

Spaces8

Tasks5

Taxes8

User scope2

Users5

Vendors (only available for accounting add-on users)4

Webhooks6

Listings

Update a listing's financial settings

Changed on Nov 3, 2026

Only accessible to Admin or User tokens.

put/financials/listing/{id}

Request

Base URL
https://open-api.guesty.com/v1
URL
https://open-api.guesty.com/v1/financials/listing/{id}
Auth
API key in header authorization

Path parameters

idstring required

Listing id

Request body

guestsIncludedInRegularFeenumber

The maximum number of guests accommodated before the extraPersonFee applies

extraPersonFeenumber float

The amount of charged for each extra person, above the accommodation default (guestsIncludedInRegularFee)

basePricenumber float

The default rate per night. This will apply to the weekend if no weekend price is defined.

basePriceUSDnumber float

The default per night in USD

monthlyPriceFactornumber float

The monthly length of stay discount. It is written as a decimal and represented as 100% less the discount. E.g.,0.8 grants a 20% discount. Accepted values are float values between 0 and 1.

weeklyPriceFactornumber float

The weekly length of stay discount. It is written as a decimal and represented as 100% less the discount. E.g. 0.95 grants a 5% discount. Accepted values are float values between 0 and 1.

weekendBasePricenumber float

The base pricefor weekend stays

securityDepositFeenumber float

The security deposit fee charged for reservations at this listing.

currencystring

The currency to be used for bookings at the property. Choose from this list of ISO 4217 alphabetic codes. E.g., USD.

Example request

{
  "guestsIncludedInRegularFee": 6,
  "extraPersonFee": 55.5,
  "basePrice": 150,
  "basePriceUSD": 100,
  "monthlyPriceFactor": 0.8,
  "weeklyPriceFactor": 0.95,
  "weekendBasePrice": 150,
  "securityDepositFee": 100,
  "currency": "USD",
  "cleaningFee": {
    "value": {
      "formula": 50
    },
    "lastUpdatedAt": "2020-12-01",
    "airbnb": {
      "value": {
        "formula": 50
      }
    },
    "rentalsUnited": {
      "value": {
        "formula": 50
      }
    },
    "homeAway": {
      "value": {
        "formula": 50
      }
    },
    "expedia": {
      "value": {
        "formula": 50
      }
    },
    "despegar": {
      "value": {
        "formula": 50
      }
    },
    "bookingCom": {
      "value": {
        "formula": 50
      }
    }
  }
}

Response

The Updated financials object

guestsIncludedInRegularFeenumber

The maximum number of guests accommodated before the extraPersonFee applies.

extraPersonFeenumber float

The amount of fee which is added for each extra person, above guestsIncludedInRegularFee, in the reservation

basePricenumber float

The cost per night for the listing