Get yearly stats for a listing.
GET/listings/:listing_id/kpis/yearly
Returns per-year performance stats, ordered oldest-to-newest.
Covers both past and future years — from 5 calendar years ago through the year containing
the date 12 months from now, subject to the years Wheelhouse holds data for. The current year
and the next one are forward-looking: they reflect the bookings on the books so far plus
asking rates for nights that are still open, so they are not final and will change as
bookings come in. Compare a year's year value against today's date to tell which side of
the line it falls on.
All monetary values are in the listing's currency.
Request
Responses
- 200
- 401
- 403
- 404
- 429
Yearly KPIs.
API key authorization failed.
Listing authorization failed.
Listing not found.
Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the Rate Limits section in the overview for the recommended exponential backoff strategy.