---
title: "Rate's settings"
method: GET
path: "/v2/rates/settings"
tags: ["Rates"]
---

# Rate's settings

`GET /v2/rates/settings`

Returns rate settings for the houseId.

## Query parameters

- `houseId` integer

## Response `200`

Success

- LodgifyApiRatesModelsV2RateSettings
  - `bookability` integer — Indicates the booking type for this property. Returned as an integer value. 0 = Instant Booking (reservations are confirmed automatically), 1 = Booking Request (reservations require host approval before being confirmed), 2 = Enquiry Only (guests can only send enquiries and cannot make bookings directly)
  - `check_in_hour` integer, nullable — If present, minimum hour allowed to check in -1: Flexible, 0-23: Hour of day
  - `check_out_hour` integer, nullable — If present, maximum hour allowed to check out -1: Flexible, 0-23: Hour of day
  - `booking_window_days` integer — Limits how many days in advance guests can book.
  - `advance_notice_days` integer — Specifies the minimum number of days in advance that a guest has to make a reservation. Guests cannot make a reservation less than this many days before the check-in date.
  - `advance_notice_hours` integer, nullable — Specifies the minimum number of hours in advance that a guest has to make a reservation, applied in addition to advance_notice_days. Guests cannot make a reservation less than this many hours before the check-in date.
  - `preparation_time_days` integer — Indicates the time between bookings when reservations are not allowed
  - `currency_code` string, nullable — Currency code
  - `vat` number, double — VAT amount
  - `is_vat_exclusive` boolean — Indicates if the price includes or excludes VAT (true is exclusive/no VAT, false is inclusive)
  - `fees` LodgifyApiRatesModelsV2RateFee[], nullable — List of fees applied to this room rate
    - `fee_name` string, nullable — Name of the fee
    - `fee_type` string, nullable — Type of the fee
    - `applied_for_nights` integer, nullable — Fee is applied only if the stay of nights is less or equal than the amount nights
    - `charge_type` string, nullable — Type of charge. Possible values are: "PerQuantity", "SingleCharge", "PerPerson", or "PerRoom"
    - `frequency` string, nullable — Frequency, can be either "PerStay" or "PerNight"
    - `price` LodgifyApiRatesModelsV2RateFeePrice — Rate fee price
      - `is_vat_exclusive` boolean — Indicates if the fee price is vat exclusive
      - `vat_percentage` number, double — VAT percentage value (only defined if not inclusive)
      - `rate_type` string, nullable — Rate type, equals "Fixed" for a fixed amount price, "Percentage" for a percentage price
      - `amount` number
      - `percentage` number, double, nullable — Price value percentage
  - `taxes` LodgifyApiRatesModelsV2RateTax[], nullable — List of taxes applied to this room rate
    - `tax_name` string, nullable — Name of the tax
    - `tax_type` string, nullable — Type of the tax
    - `charge_type` string, nullable — Type of charge. Possible values are: "PerQuantity", "SingleCharge", "PerPerson", or "PerRoom"
    - `frequency` string, nullable — Frequency, can be either "PerStay" or "PerNight"
    - `price` LodgifyApiRatesModelsV2RatePrice — Rate price
      - `rate_type` string, nullable — Rate type, equals "Fixed" for a fixed amount price, "Percentage" for a percentage price
      - `amount` number
      - `percentage` number, double, nullable — Price value percentage
  - `promotions` LodgifyApiRatesModelsV2RatePromotion[], nullable — List of promotions applied to this room rate
    - `name` string, nullable — Promotion name
    - `price` LodgifyApiRatesModelsV2RatePrice — Rate price
      - `rate_type` string, nullable — Rate type, equals "Fixed" for a fixed amount price, "Percentage" for a percentage price
      - `amount` number
      - `percentage` number, double, nullable — Price value percentage
    - `early_booker_days` integer, nullable — Indicates the amount of nights or more before arrival to apply the promotion
    - `last_minute_days` integer, nullable — Indicates the amount of days nights or less before arrival to apply the promotion
    - `minimum_stay_days` integer, nullable — Indicates the type nights minimum stay required to apply the promotion
    - `booking_dates` LodgifyRatesModelsV1DateRangeModel[], nullable — Promotion is applied only if booked during the specific date range (if empty, will always be applied if other conditions are met). Inclusive start and end dates - for example, if start and end dates are 1st and 3rd of January, bookings made on the 1st, 2nd and 3rd of January for the given stay dates will apply the promotion. Limited booking dates for promos are not supported in some newer versions of the Lodgify UI.
      - `lower` string
      - `upper` string
    - `stay_dates` LodgifyRatesModelsV1DateRangeModel[], nullable — Date range when the promotion applies (if empty, will be applied for all dates if other conditions are met). Inclusive start and end dates - if start and end dates are 1st and 3rd of January, the promo will be applied for the nights of the 1st, 2nd AND 3rd of January. Applying promos only to specific date ranges is not supported in some newer versions of the Lodgify UI.
      - `lower` string
      - `upper` string
    - `codes` LodgifyApiRatesModelsV2RatePromotionCode[], nullable — List of valid codes that can be used by guests to apply to this promotion
      - `code` string, nullable — Promotion code
      - `is_active` boolean — Indicates if the promotion code is active

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Server Error

---

[API](https://skmtc.net/lodgify/apis/lodgify-public-api-v1.md) · [All operations](https://skmtc.net/lodgify/apis/lodgify-public-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lodgify/lodgify-public-api-v1/revisions/ddf40757d411/schema)