Get the price calendar for a listing.
GET/listings/:listing_id/price_calendar
Returns the price calendar for a single listing. Each entry represents one stay date and includes the price, availability, and booking state.
The data reflects the current state of the calendar as of the time of the request:
- Future dates — the current price and availability as they stand right now.
- Past dates — the state the date ended up in (e.g. whether it was booked, blocked, or left available, and the price that was in effect at the time).
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
- 429
Array of calendar day entries ordered by stay date.
Date range exceeds the 3-year maximum.
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.