# Vrbo Availability API Documentation

<p>Get the day by day calendar of a Vrbo property for up to 735 days. Each day says if it is available, the nightly price, if check-in and check-out are possible and the minimum and maximum stay. Default: the next 365 days.</p>

- **Documentation:** [https://scrappa.co/docs/vrbo-api/vrbo_listing_availability](https://scrappa.co/docs/vrbo-api/vrbo_listing_availability)
- **API group:** Vrbo API
- **Endpoint:** `GET https://scrappa.co/api/vrbo/listing/availability`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `property_id` | string | Yes | Numeric property_id from /api/vrbo/search. Example: 124807895. |
| `start_date` | string | No | First day, YYYY-MM-DD. Default: today. |
| `end_date` | string | No | Last day, YYYY-MM-DD, at most 735 days from today. Default: 365 days after the start date. |

## Example response

```json
{
    "data": {
        "days": [
            {
                "date": "2026-12-01",
                "price": 433,
                "check_in": "VALID",
                "min_stay": 2,
                "available": true,
                "check_out": "VALID",
                "price_formatted": "$433"
            }
        ],
        "end_date": "2026-12-07",
        "start_date": "2026-12-01",
        "property_id": "124807895",
        "available_days": 5,
        "max_available_days": 735
    },
    "meta": {
        "billable": true,
        "endpoint_family": "availability_calendar"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | Vrbo has no property for this property_id. This response is not billable. |
| 422 | Validation Error | A parameter is missing or invalid. No upstream request is made. This response is not billable. |
| 503 | Vrbo Temporarily Unavailable | Vrbo did not answer in time or the request was blocked. Retry after a short pause. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)