# Pricing Tiers

> Web version: https://docs.usewheelhouse.com/rm/concepts/pricing-tiers

Each listing is on a pricing tier, which `GET /listings/{listing_id}/pricing_tier`
returns as `name`. The tier sets how far ahead price recommendations reach and
which features the listing can use. There are five tiers:

| Tier | What it is |
|---|---|
| `Free` | No Pro plan. |
| `Pro Flex`, `Pro Flat` | The paid Pro plans. They differ in how they are billed, not in what the API allows. |
| `Pro Trial` | A trial of Pro, with the same access as the paid Pro plans. |
| `Pro Onboarding` | An onboarding plan, with the same access as the paid Pro plans except that Wheelhouse does not post prices to the channel on most channels. |

Every tier except `Free` counts as a **Pro listing** wherever these docs say so.

## What each tier allows

| | `Free` | `Pro Flex`, `Pro Flat`, `Pro Trial` | `Pro Onboarding` |
|---|---|---|---|
| `GET /listings/{listing_id}/price_recommendations` | 30 days ahead by default | 545 days (18 months) ahead by default | 545 days (18 months) ahead by default |
| `GET /listings/{listing_id}/price_calendar` | Today through 545 days ahead by default, up to 3 years per request | Same | Same |
| `GET /listings/{listing_id}/calendar_day_history` | **402 Payment Required** | Stay dates up to 180 days back | Stay dates up to 180 days back |
| Market report endpoints (`/market_report`) | **404 Not Found** for a market where you hold only `Free` listings | Available | Available |
| `POST /listings/{listing_id}/sync` | **429 Too Many Requests** | No daily limit | **429 Too Many Requests** |
| Automatic price posting | Not available (except on some channels) | Available, and on when `automatic_rate_posting_enabled` is `true` | Not available (except on some channels) |

The `price_recommendations` horizons are defaults. Some channels give longer
ones, for `Free` listings up to 180 days. On some channels, a Pro listing due to
move to `Free` already gets the `Free` horizon. A custom horizon configured for a
listing replaces all of these, and `GET /listings/{listing_id}/pricing_tier`
reports it as `horizon`.

`price_recommendations` and `price_calendar` reach different distances because
they return different things. `price_recommendations` computes Wheelhouse
recommendations, and the tier limits how many days it computes.
`price_calendar` returns the price and availability stored for each date, so
its range does not depend on the tier.

The market report endpoints return **404 Not Found**, not **402**, for a market
without a Pro listing, and `GET /market_report` lists only markets where you
hold one.

## Dynamic sets have their own plan

Dynamic sets are billed separately from listing tiers. Each set is free or paid
(`is_paid`), and the set-level analytics endpoints return **404 Not Found** for
a free set. See [Dynamic Sets](https://docs.usewheelhouse.com/rm/concepts/dynamic-sets.md) for the endpoints that need a
paid set.
