# Listing Preferences

> Wheelhouse Revenue Management API. Web version: https://docs.usewheelhouse.com/rm/reference/listing-preferences · OpenAPI spec: https://docs.usewheelhouse.com/rm/openapi.yaml

Read and update detailed pricing preferences for listings, including base price, seasonality, discounts, min stay rules, and more.

> **Note:** These preferences are called **"Settings"** in the Wheelhouse app.

## Settings your channel may not support

Not every channel can act on every setting. Some have no concept of check-in/check-out day rules, some cannot take minimum stays, and support for long-term discounts ranges from none at all, through fixed weekly and monthly tiers, to arbitrary ones. Which settings a listing accepts therefore depends on the channel it is connected to.

A setting the channel cannot act on is **not applied** — it is discarded rather than stored, so it never appears to have taken effect. The rest of the request still applies, and the response is still a success.

Each listing reports what it accepts as `supported_settings`, on both the listing object and the preferences object. Read it before sending a setting rather than after: a setting reported `false` will be discarded. It reflects any per-account early access, so two listings on the same channel can differ.

Every write also returns `warnings`, naming each setting that was not applied, why, and which attributes it covered. The array is present and empty when everything applied, so it can be read unconditionally. `reason` is `not_supported_by_channel` when the channel has no such feature, or `partially_supported_by_channel` when it accepts a narrower form than what was sent and only the excess was dropped. `reason` is `not_supported_for_multi_unit` for a setting that is stored but has no effect because the listing has more than one unit; today that is only `gap_night`.

## UI settings panel groups

The Wheelhouse Settings panel organizes preferences into labeled groups. The table below maps each group to its corresponding API fields.

| UI Group | UI Setting Name | API Field(s) |
|---|---|---|
| Pricing Engine | Base price | `base_price`, `base_price_adjustment` |
| Pricing Engine | Seasonality | `seasonality_adjustment` |
| Pricing Engine | Day of week | `day_of_week` |
| Pricing Engine | Local events | `demand_sensitivity_rules` |
| Pricing Engine | Last minute | `last_minute_discount` |
| Pricing Engine | Far future | `far_future_premium` |
| Pricing Engine | Gaps & Adjacencies | `gap_night` |
| Model Weights | Historical protections | `historical_anchoring_rules`, `historical_anchoring_price_source`, `historical_anchoring_mode` |
| Limits | Maximum prices | `maximum_price_rules_v3` |
| Limits | Minimum prices | `minimum_price_rules_v3`, `min_min_price` |
| Operations | Minimum stays | `minimum_stay_rules_v3`, `min_min_stay` |
| Operations | Length of stay pricing | `long_term_discounts`, `weekly_discount`, `monthly_discount` |
| Calendar Pacing | Occupancy pacing | `occupancy_pacing` |
| Configuration | Events & Seasons | `custom_date_ranges` |

`demand_sensitivity_rules` is the Local events setting. The UI name changed when day of week
became its own setting; the field name did not, so existing integrations keep working unchanged.
`historical_anchoring_*` is the same case, shown as Historical protections.

## Endpoints

- [GET /preferences](https://docs.usewheelhouse.com/rm/reference/rm-get-preferences-batch.md): Retrieve preferences for a batch of listings.
- [PUT /preferences](https://docs.usewheelhouse.com/rm/reference/rm-put-preferences-batch.md): Update preferences for a batch of listings.
- [GET /preferences/{listing_id}](https://docs.usewheelhouse.com/rm/reference/rm-get-preferences.md): Get preferences for a listing.
- [PUT /preferences/{listing_id}](https://docs.usewheelhouse.com/rm/reference/rm-put-preferences.md): Update preferences for a listing.
- [PUT /preferences/{listing_id}/copy](https://docs.usewheelhouse.com/rm/reference/rm-copy-preferences.md): Copy preferences from one listing to another.
- [PUT /preferences/{listing_id}/{setting}](https://docs.usewheelhouse.com/rm/reference/rm-put-preference-setting.md): Update a single pricing setting for a listing.
- [GET /preferences/{listing_id}/long_term_discounts](https://docs.usewheelhouse.com/rm/reference/rm-get-long-term-discounts.md): Get the long-term discount settings for a listing.
- [GET /preferences/{listing_id}/changelog](https://docs.usewheelhouse.com/rm/reference/rm-get-preferences-changelog.md): Get the changelog of all changes to a listing.
