Vrbo Availability Calendar

Use the Rapid Availability Calendar API to give a snapshot of daily availability for a property

Overview

The Rapid Availability Calendar API provides a snapshot of daily availability for a given property over a period of time, which can be used to assist a guest viewing the property details page. If the guest has other stay dates in mind, or the property is not available on the selected date, they can easily see when they could revise their search criteria to find availability. The Availability Calendar API will also return the minimum stay requirement for the property, and an explanation for why a given date is ineligible for check-in/out.

Note: Maximum stays are limited to Rapid’s 28 night limit.

vrbo availability calendar

FAQ

Q. Are daily rates returned as part of availability?

A. No, only an indication as to whether the property is bookable or not.

Q. Is minimum stay a property attribute or does it depend on the arrival date?

A. Properties can vary minimum stay requirements seasonally, so this value is provided on a daily basis.

Q. How far in advance can I see availability?

A. Up to 3 years. However, availability more than one year out may be less accurate, and bookings may be subject to cancellation by the host in the event of unexpected events or price changes.

Q. How often should I request this information?

A. The Rapid Availability Calendar API should be called on page load when the UI calendar view is displayed.

Q. Can I cache this information?

A. Caching is not supported at this time.

Example:

[
    {
        "property_id": "34641715",
        "days": [
            {
                "date": "2022-12-07",
                "available": true,
                "checkin": "CHECKIN_INVALID_DUE_TO_NO_VALID_CHECKOUT_WITHIN_CONSTRAINTS",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 2147483647
                }
            },
            {
                "date": "2022-12-08",
                "available": true,
                "checkin": "CHECKIN_INVALID_DUE_TO_NO_VALID_CHECKOUT_WITHIN_CONSTRAINTS",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 2147483647
                }
            },
            {
                "date": "2022-12-09",
                "available": true,
                "checkin": "CHECKIN_INVALID_DUE_TO_NO_VALID_CHECKOUT_WITHIN_CONSTRAINTS",
                "checkout": "CHECKOUT_VALID",
                "stay_constraints": {
                    "min_stay": 1,
                    "max_stay": 2147483647
                }
            }
        ]
    }
]
Did you find this page helpful?
How can we improve this content?
Thank you for helping us improve Developer Hub!