Get the estimated fee multiplier per stay date for a listing.
GET/listings/:listing_id/fee_impact_calendar
Returns a per-date fee multiplier derived from the listing's fee_adjustments preference (total_fee_percentage, see GET /preferences/{listing_id}). Multiply any nightly price by fee_multiplier to obtain the fee-inclusive price, for example before comparing it with neighborhood prices, which include fees.
When no fee adjustment is in effect, fee_multiplier is 1.0. Pass fallback=estimate to have it estimated instead from the fees on the listing's recent reservations, the same estimate auto_update applies. Each entry's source says where the multiplier came from.
Currently the multiplier is uniform across all dates. The per-date shape is intentional — future releases will allow fee variation by date range or season, and the response format will remain compatible.
Defaults to today through the maximum calendar horizon (1.5 years) when start_date and end_date are omitted. The total date range may not exceed 3 years.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 406
- 429
Array of fee multiplier entries ordered by stay date.
Date range exceeds the 3-year maximum, or fallback is not one of the listed values.
API key authorization failed.
Listing authorization failed.
Listing not found.
The listing is inactive. See the Inactive Listings section in the overview.
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.