Vrbo Availability Calendar

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

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
                }
            }
        ]
    }
]

Learn more about the Availability Calendar in the Rapid API schema.


API details

Explore the related endpoint definitions on this page, then use the API Explorer or another testing software to get an understanding of how the examples and schema definitions compare to the actual output.


Additional resources

Whether you're looking to try out all the Rapid API endpoints or to download its OpenAPI specs or our Postman collection, we have you covered.



Did you find this page helpful?
How can we improve this content?
Thank you for helping us improve!