---
title: "Get Airbnb Listing Price and Rules"
method: GET
path: "/listings/airbnb/price_and_rules"
tags: ["Listing Calendar"]
---

# Get Airbnb Listing Price and Rules

`GET /listings/airbnb/price_and_rules`

Fetch the current pricing, availability rules and booking settings of an Airbnb listing in real time from Airbnb. The response fields mirror the `settings` object accepted by `POST /listings/airbnb/price_and_rules`, so values read here can be written back as-is.

This endpoint calls multiple Airbnb APIs per request and therefore shares the stricter rate limit of write operations (120 requests per minute).

## Query parameters

- `listing_id` string, required — The unique identifier for different channels. <br>For example, the listing id for Airbnb is the Airbnb listing id, and the listing id for Booking.com is the Booking.com room id - rateplan id.

## Response `200`

The current price and rules of the Airbnb listing.

- object
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.
  - `data` object, required
    - `listing_currency` string — The listing currency code, e.g. `USD`.
    - `base_price` number — The default nightly price.
    - `weekend_price` number, nullable — The Friday and Saturday nightly price. `null` when not set.
    - `security_deposit` number — The security deposit amount.
    - `cleaning_fee` number — The cleaning fee amount.
    - `short_term_cleaning_fee` number, nullable — The short-term cleaning fee amount. `null` when not set.
    - `pet_fee` number, nullable — The pet fee amount. `null` when not set.
    - `pet_fee_obj` object, nullable — The detailed pet fee. `null` when not set.
      - `amount` number
      - `charge_type` string
      - `charge_period` string
    - `extra_guest_fee` number, nullable — The fee charged per extra guest.
    - `early_bird_discount` object[] — Early bird discounts: `discount` percent off when booked at least `days` days ahead.
      - `discount` integer — Discount percentage (0-100).
      - `days` integer
    - `last_minute_discount` object[] — Last minute discounts: `discount` percent off when booked within `days` days of check-in.
      - `discount` integer — Discount percentage (0-100).
      - `days` integer
    - `long_term_discount` object[] — Long term discounts: `discount` percent off for stays of at least `days` nights.
      - `discount` integer — Discount percentage (0-100).
      - `days` integer
    - `check_in_start_time` unknown
    - `check_in_end_time` unknown
    - `check_out_before` integer — Check-out latest time, an integer hour 0-23.
    - `instant_booking` boolean — Whether instant booking is allowed.
    - `max_guests` integer — The number of guests included in the base price.
    - `minimum_stay` integer — The default minimum number of nights.
    - `maximum_stay` integer — The default maximum number of nights.
    - `advance_notice` integer, nullable — Booking lead time in hours.
    - `availability_window` integer — How far in advance (in days) the calendar is bookable.
    - `preparation_time` integer — Turnover/preparation days between reservations.
    - `days_of_week_check_in` integer[] — Days of week (0=Sunday ... 6=Saturday) on which check-in IS allowed.
    - `days_of_week_check_out` integer[] — Days of week (0=Sunday ... 6=Saturday) on which check-out IS allowed.
    - `allow_rtb_above_max_nights` boolean — Whether request-to-book is allowed for stays exceeding the maximum nights.
    - `cancellation_policy` unknown
    - `long_term_cancellation_policy` unknown
    - `non_refundable_price_factor` number, nullable — The non-refundable discount percentage (0-100). `null` when the non-refundable option is off.
    - `day_of_week_min_nights` object[] — Per-day-of-week minimum nights rules; only days with a minimum-nights override are returned.
    - `seasonal_min_stay` object[] — Seasonal minimum nights rules.
    - `new_listing_promotion` boolean — Whether the Airbnb new listing promotion is currently ongoing.
    - `high_rated_guest_discount` boolean — Whether the Airbnb highly-rated guest discount (15% off for guests rated 4.8+ with at least 3 reviews) is currently enabled.
    - `mobile_only_discount` boolean — Whether the Airbnb mobile-only discount (10% off for guests booking via the Airbnb mobile app) is currently enabled.
    - `eligible_cancellation_policies` string[] — Cancellation policy categories this listing is eligible for; these are the valid values for `cancellation_policy` when updating.

---

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