Vrbo

GET
# Destination Search API

## Overview

Authenticate with X-API-Key. One successful call consumes one credit.

### Endpoint URL

GET https://api.stayapi.com/v1/vrbo/search 

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| region\_id | string | Required | Numeric string, up to 30 digits. |
| check\_in | date | Required | Strict YYYY-MM-DD. |
| check\_out | date | Required | Strict YYYY-MM-DD, checkout after check-in. |
| adults | integer | Optional | 1–8. Default: 2. |
| offset | integer | Optional | 0–1000. Default: 0. |
| limit | integer | Optional | 1–10. Default: 10. |
| currency | string | Optional | Default: USD. Only USD is accepted, including case/whitespace-normalized USD. |

## Response scope

Returns `region_id, region_name, check_in, check_out, adults, currency, offset, limit, count, properties, next_offset, next_limit` and `availability_verified: false`. Each primary card has `property_id, name, canonical_url` and `listing_id`. Use internal `property_id` for reviews; public `listing_id` belongs in the Vrbo URL and may end in `ha`. Prices are omitted: to price a listing, pass its `property_id` to [Expedia Hotel Rates](/docs/endpoints/expedia/hotel-rates) with your dates and use the rate plan's total price, which can include rental fees. Discovery does not confirm availability. Continue only with the returned next\_offset/next\_limit pair; nullable continuation does not claim exhaustive inventory.

Vrbo native property-name lookup is not available. REST only; no MCP tool.

## Errors

Invalid requests return 400 or 422 Problem Details. Upstream failures return 502, 503, or 504. Respect Retry-After when supplied; do not treat an error as empty results.

Request

```curl
curl 'https://api.stayapi.com/v1/vrbo/search?region_id=2693&check_in=2027-02-10&check_out=2027-02-12' -H 'X-API-Key: YOUR_API_KEY'
```

Response

```json
{
  "region_id": "2693",
  "region_name": "Orlando",
  "check_in": "2027-02-10",
  "check_out": "2027-02-12",
  "adults": 2,
  "currency": "USD",
  "offset": 0,
  "limit": 10,
  "count": 1,
  "availability_verified": false,
  "properties": [
    {
      "property_id": "124565672",
      "name": "The Ocean's Cove - Free Parking",
      "canonical_url": "https://www.vrbo.com/5031607",
      "listing_id": "5031607"
    }
  ],
  "next_offset": null,
  "next_limit": null
}
```

```json
{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "Invalid request parameters",
  "instance": "/v1/vrbo/search",
  "provider": "vrbo"
}
```
