OutReserve API

Access campgrounds, destinations, and property data to power your mobile app, travel platform, or AI integration.

The OutReserve API is designed for developers, partners, and AI platforms.

Request an API Key Getting Started

Who is this for?

The OutReserve API is designed for developers, partners, and AI platforms.

Mobile Developers

Build iOS and Android apps powered by real-time campground and destination data.

Travel Partners

Integrate OutReserve inventory into your travel platform or booking engine.

AI & MCP Platforms

Build AI-powered travel assistants and MCP integrations using our property and destination data.

New: AI Integration

Connect AI Assistants to OutReserve

Our MCP server lets AI assistants like Claude, Cursor, and Windsurf search campgrounds, check availability, and manage properties on behalf of operators.

Learn About MCP Integration

Getting Started

Authentication

Every request to the OutReserve API requires a valid API key. You can pass it as a query parameter or in the Authorization header.

# Pass your key as a query parameter

GET https://outreserve.com/api/v1/stays/search?apikey=oraks_xxx&q=yosemite

# Or use the Authorization header

Authorization: Bearer oraks_xxx

Localization & Pagination

Use the language and currency parameters to localise responses. Pagination is supported on all collection endpoints.

language e.g. en-US, de-DE (default: en-US)

currency e.g. USD, EUR (default: USD)

limit Results per page (default 25, max 100)

page Page number for paginated results

Available Endpoints

Method	Endpoint	Description
GET	/api/v1/countries	Countries Index
GET	/api/v1/countries/:id	Countries Show
GET	/api/v1/countries/:id/states	States Index
GET	/api/v1/countries/:id/states/:id	States Show
GET	/api/v1/countries/:id/states/:id/destinations	Destinations Index
GET	/api/v1/countries/:id/states/:id/destinations/:id	Destinations Show
GET	/api/v1/stays/properties/:uuid	Properties Show
GET	/api/v1/stays/search	Search Index
POST	/api/v1/stays/availability_alerts	Availability Alerts Create
GET	/api/v1/stays/availability_alerts/:uuid	Availability Alerts Show

Location Hierarchy

Countries, States & Destinations

Drill down through the geographic hierarchy to discover regions and popular destinations. Each resource includes property counts and (where available) pricing statistics from our cached aggregates.

GET /api/v1/countries

Returns all countries with active listings. Use the slug for further nesting.

# Example response

{

"data": [

{ "id": 1, "name": "United States", "slug": "united-states", "abbreviation": "US", "latitude": 39.5, "longitude": -98.35, "properties_count": 12480 },

...

"meta": { "page": 1, "limit": 25, "total_count": 2, "total_pages": 1 }

}

GET /api/v1/countries/united-states/states

States are scoped to a country. Rich stats include benchmark occupancy and ADR when available.

# Example response (abridged)

{

"data": [{

"name": "California", "slug": "california", "abbreviation": "CA",

"description": "Home to Yosemite, Big Sur and world-class RV parks...",

"has_outline": true,

"stats": { "properties_count": 3120, "benchmark_occupancy_pct": 0.684, ... }

}], "meta": { ... }}

}

GET /api/v1/countries/united-states/states/california/destinations

Destinations are ordered by popularity (property count + featured flag). Includes cached nightly rate ranges.

# Single destination example

GET /api/v1/countries/united-states/states/california/destinations/yosemite-national-park

{

"data": {

"name": "Yosemite National Park", "slug": "yosemite-national-park", "category": "national-park",

"featured": true, "properties_count": 87,

"average_nightly_rate": 89.5, "lowest_nightly_rate": 45, "highest_nightly_rate": 320

}

All location endpoints support ?page=2&limit=50 and return the standard data + meta envelope for collections.

Availability Alerts

Monitor Properties for Availability

Create alerts to monitor campgrounds and RV parks for open dates. Get notified via webhook when sites become available for your desired dates and unit type.

Note: For API key authentication, user_uuid is optional. If omitted, the alert is created as an API-only alert tied to your API key. Save the returned uuid to check status later.

# 1. Create an availability alert

POST /api/v1/stays/availability_alerts

{

"property_uuid": "prop_xxx",

"start_date": "2026-06-15",

"end_date": "2026-06-20",

"unit_type": "rv",

"webhook_url": "https://your-site.com/webhook"

}

# Optional: add "user_uuid" to associate with a user

# 2. POST Response - Save this UUID

{

"data": {

"alert": {

"uuid": "alt_abc123xyz",

"property_uuid": "prop_xxx",

"status": "pending",

"start_date": "2026-06-15",

"end_date": "2026-06-20"

}

# Use this uuid for GET requests to check status

# 3. Check alert status (using saved UUID)

GET /api/v1/stays/availability_alerts/alt_abc123xyz

# Response includes live availability status:

{

"data": {

"alert": { ... },

"live_status": {

"property_available": true,

"matching_units_count": 3,

"matching_units": [...],

"checked_at": "2026-05-20T21:35:00Z"

}

Webhook Payload

When availability opens, we send a signed webhook to your configured URL:

# Webhook event payload

{

"type": "availability.opened",

"data": {

"alert_uuid": "alt_xxx",

"property_name": "Yosemite Pines",

"user_uuid": "usr_xxx",

"booking_url": "https://outreserve.com/..."

"timestamp": "2026-05-20T21:35:00Z"

}

Verify the signature using your webhook_secret with HMAC-SHA256.

Affiliates & Partnerships

Join our affiliate and partnership programme to earn commissions by integrating OutReserve into your platform, app, or content.

Competitive commission rates on every booking referred through your integration.
Real-time reporting and analytics dashboard for your referrals.
Dedicated partner support and co-marketing opportunities.

Interested in becoming a partner? Contact us at developers@outreserve.com

Up to 10%

commission on referred bookings

Frequently Asked Questions About our API

Have a question, found a bug, or need help getting started? We are here to help.

Request an API Key

Fill in the form below and our team will review your request. You will receive your API key within 2 business days.

Have a question, found a bug, or need help getting started? We are here to help. developers@outreserve.com