Getting Started with the Vacation Rentals API
The Xeni Vacation Rentals API lets you search for and book a wide range of rental property types beyond traditional hotels and resorts. This API supports condos, apartments, cottages, houseboats, mobile homes, aparthotels, and condominium resorts.
What Are Vacation Rentals?
Vacation rentals are alternative accommodation types that provide a home-like experience for travelers. Unlike standard hotel rooms, vacation rentals often include full kitchens, multiple bedrooms, and private outdoor spaces.
Supported Property Types
| Property Type | Description |
|---|---|
| Condo | Individually owned units within a larger building, typically with shared amenities |
| Apartment | Self-contained residential units, often in urban locations |
| Cottage | Small standalone homes, often in rural or coastal settings |
| Houseboat | Floating accommodation on lakes, rivers, or coastal waterways |
| Mobile Home | Transportable residential units, often in resort or park settings |
| Aparthotel | Hybrid properties combining apartment-style rooms with hotel services |
| Condominium Resort | Resort complexes made up of individually owned condo units |
How It Differs from Hotels and Resorts
| Feature | Hotels/Resorts API | Vacation Rentals API |
|---|---|---|
| Endpoint | /hotels/api/v2/properties | /hotels/api/v2/properties/vacation-rentals |
| Property types | Hotels and resorts | Condos, apartments, cottages, houseboats, etc. |
| Property type filter | Not applicable | vacation_rentals array in request body |
| Autocomplete | Same endpoint | Same endpoint |
| Correlation ID | Required | Required |
/vacation-rentals) and the ability to filter by specific rental property types.
Integration Flow
The integration follows a two-step process:
- Autocomplete — Search for a destination using the shared autocomplete endpoint. Capture the
x-correlation-idfrom the response header. - Search — Send a search request to the vacation rentals endpoint with the correlation ID, dates, occupancy, and optional property type filters.
Step 1: GET /hotels/api/v2/autocomplete?key=lake+tahoe
← Response header: x-correlation-id: corr_abc123
Step 2: POST /hotels/api/v2/properties/vacation-rentals?currency=USD&page=1&limit=50
→ Header: x-correlation-id: corr_abc123
→ Body: { checkindate, checkoutdate, occupancy, lat, long, ... }
← Response: { status: "success", data: { total, hotels: [...] } }
Authentication
The Vacation Rentals API uses the same authentication as the rest of the Xeni API Collection. Refer to the Xeni API authentication documentation for details on Auth V2 and required headers.
Environments
| Environment | Base URL | Purpose |
|---|---|---|
| UAT (Sandbox) | https://uat.travelapi.ai | Development and testing |
| Production | https://api.travelapi.ai | Live environment with real bookings |
Next Steps
Start by learning how to search for vacation rental locations using the autocomplete endpoint.