Skip to main content

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:

TierWhat it is
FreeNo Pro plan.
Pro Flex, Pro FlatThe paid Pro plans. They differ in how they are billed, not in what the API allows.
Pro TrialA trial of Pro, with the same access as the paid Pro plans.
Pro OnboardingAn 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​

FreePro Flex, Pro Flat, Pro TrialPro Onboarding
GET /listings/{listing_id}/price_recommendations30 days ahead by default545 days (18 months) ahead by default545 days (18 months) ahead by default
GET /listings/{listing_id}/price_calendarToday through 545 days ahead by default, up to 3 years per requestSameSame
GET /listings/{listing_id}/calendar_day_history402 Payment RequiredStay dates up to 180 days backStay dates up to 180 days back
Market report endpoints (/market_report)404 Not Found for a market where you hold only Free listingsAvailableAvailable
POST /listings/{listing_id}/sync429 Too Many RequestsNo daily limit429 Too Many Requests
Automatic price postingNot available (except on some channels)Available, and on when automatic_rate_posting_enabled is trueNot 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.