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 for the endpoints that need a
paid set.