---
title: "Update listing Financials"
method: PUT
path: "/financials/listing/{id}"
tags: ["Listings"]
---

# Update listing Financials

`PUT /financials/listing/{id}`

Only accessible to Admin or User tokens.

## Path parameters

- `id` string, required

## Request body

- object — Select financials fields with updated values. Non-updated fields are not required in the body
  - `guestsIncludedInRegularFee` number — The higest number of guests that will not reauires to add extraPersonFee
  - `extraPersonFee` number — The amount of fee which is added for each extra person, above guestsIncludedInRegularFee, in the reservation
  - `basePrice` number — The cost per night for the listing
  - `basePriceUSD` number — The cost per night in USD for the listing
  - `monthlyPriceFactor` number — A factor for the nightly cost for reservations that are longer then a month
  - `weeklyPriceFactor` number — A factor for the nightly cost for reservations that are longer then a week
  - `weekendBasePrice` number — The base price for weekend
  - `securityDepositFee` number
  - `currency` string — The currency that is in use for the listing prices
  - `cleaningFee` object — Object to define cleaningFee settings
    - `value` object — Default settings for cleaning fee
      - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
      - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
      - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
    - `lastUpdatedAt` string, date — Last update date
    - `airbnb` object — For channel specific cleaningFee settings, the 'value' field will be saved under the channel name
      - `value` object
        - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
        - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
        - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
        - `_id` string
    - `rentalsUnited` object — For channel specific cleaningFee settings, the 'value' field will be saved under the channel name
      - `value` object
        - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
        - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
        - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
        - `_id` string
    - `homeAway` object — For channel specific cleaningFee settings, the 'value' field will be saved under the channel name
      - `value` object
        - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
        - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
        - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
        - `_id` string
    - `expedia` object — For channel specific cleaningFee settings, the 'value' field will be saved under the channel name
      - `value` object
        - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
        - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
        - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
        - `_id` string
    - `despegar` object — For channel specific cleaningFee settings, the 'value' field will be saved under the channel name
      - `value` object
        - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
        - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
        - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
        - `_id` string
    - `bookingCom` object — For channel specific cleaningFee settings, the 'value' field will be saved under the channel name
      - `value` object
        - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
        - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
        - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
        - `_id` string

## Response `200`

The Updated financials object

- object
  - `guestsIncludedInRegularFee` number — The higest number of guests that will not reauires to add extraPersonFee
  - `extraPersonFee` number — The amount of fee which is added for each extra person, above guestsIncludedInRegularFee, in the reservation
  - `basePrice` number — The cost per night for the listing
  - `basePriceUSD` number — The cost per night in USD for the listing
  - `monthlyPriceFactor` number — A factor for the nightly cost for reservations that are longer then a month
  - `weeklyPriceFactor` number — A factor for the nightly cost for reservations that are longer then a week
  - `weekendBasePrice` number — The base price for weekend
  - `securityDepositFee` number
  - `currency` string — The currency that is in use for the listing prices
  - `cleaningFee` object — Object to define cleaningFee settings
    - `value` object — Default settings for cleaning fee
      - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
      - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
      - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
    - `lastUpdatedAt` string, date — Last update date
    - `airbnb` object — For channel specific cleaningFee settings, the 'value' field will be saved under the channel name
      - `value` object
        - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
        - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
        - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
        - `_id` string
    - `rentalsUnited` object — For channel specific cleaningFee settings, the 'value' field will be saved under the channel name
      - `value` object
        - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
        - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
        - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
        - `_id` string
    - `homeAway` object — For channel specific cleaningFee settings, the 'value' field will be saved under the channel name
      - `value` object
        - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
        - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
        - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
        - `_id` string
    - `expedia` object — For channel specific cleaningFee settings, the 'value' field will be saved under the channel name
      - `value` object
        - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
        - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
        - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
        - `_id` string
    - `despegar` object — For channel specific cleaningFee settings, the 'value' field will be saved under the channel name
      - `value` object
        - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
        - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
        - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
        - `_id` string
    - `bookingCom` object — For channel specific cleaningFee settings, the 'value' field will be saved under the channel name
      - `value` object
        - `valueType` 'FIXED' | 'PERCENTAGE' — Defines rather value is a fixed number or percentage
        - `multiplier` 'PER_STAY' | 'PER_GUEST' | 'PER_NIGHT' | 'PER_GUEST_PER_NIGHT' — Sets the factor by which cleaning fee value will be multiplied
        - `formula` number — Defines the cleaningFee value, as fixed or as a percentage accordinf to 'valueType'
        - `_id` string

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)