Quickstart

Get up and running with the WedStay API in three steps.

Step 1: Get your API key

API keys are issued manually during the beta period. Email info@thewedstay.com with subject line "WedStay API Key Request" and include your name, what you're building, and expected usage.

We typically respond within 24 hours.

Step 2: Search venues

Find wedding venues by state, city, capacity, or price range.

Search venues in California

curl -X GET "https://www.thewedstay.com/api/v1/venues?state=california&capacity_min=20" \
  -H "Authorization: Bearer ws_live_..."

Response

{
  "data": [
    {
      "slug": "california/palm-springs/palm-springs-wedding-estate-...",
      "name": "Palm Springs Wedding Estate",
      "city": "Palm Springs",
      "state": "California",
      "venue_type": "estate",
      "capacity_min": 10,
      "capacity_max": 50,
      "bedrooms": 6,
      "price_range": "$1,000 - $1,500/night",
      "hero_image": "https://www.thewedstay.com/cdn-images/property-photos/.../exterior-medium.webp",
      "seo_description": "Stunning mid-century estate with pool, hot tub, and mountain views.",
      "amenities": ["pool", "hot-tub", "outdoor-ceremony"],
      "url": "https://www.thewedstay.com/properties/california/palm-springs/palm-springs-wedding-estate-..."
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJ...",
    "total_count": 42
  },
  "request_id": "req_abc123def456"
}

Step 3: Get venue details

Fetch full details for a specific venue including photos, amenities, and pricing.

Get venue details

curl -X GET "https://www.thewedstay.com/api/v1/venues/palm-springs-wedding-estate-with-retro-pool-vibes-hollywood-history-sleeps-12" \
  -H "Authorization: Bearer ws_live_..."

Step 4: Calculate pricing

Use the pricing calculator to estimate costs for a specific event.

Calculate pricing

curl -X GET "https://www.thewedstay.com/api/v1/venues/pricing?region=california&event_guests=80&nights=3&season=peak" \
  -H "Authorization: Bearer ws_live_..."

Next steps

Venue endpoints — Full search and filter reference
Vendor endpoints — Search wedding vendors
Pricing calculator — Detailed pricing API
Submit inquiries — Send booking requests
Error handling — Error codes and troubleshooting

Quickstart

Get up and running with the WedStay API in three steps.

Step 1: Get your API key

API keys are issued manually during the beta period. Email info@thewedstay.com with subject line "WedStay API Key Request" and include your name, what you're building, and expected usage.

We typically respond within 24 hours.

Step 2: Search venues

Find wedding venues by state, city, capacity, or price range.

Search venues in California

curl -X GET "https://www.thewedstay.com/api/v1/venues?state=california&capacity_min=20" \
  -H "Authorization: Bearer ws_live_..."

Response

{
  "data": [
    {
      "slug": "california/palm-springs/palm-springs-wedding-estate-...",
      "name": "Palm Springs Wedding Estate",
      "city": "Palm Springs",
      "state": "California",
      "venue_type": "estate",
      "capacity_min": 10,
      "capacity_max": 50,
      "bedrooms": 6,
      "price_range": "$1,000 - $1,500/night",
      "hero_image": "https://www.thewedstay.com/cdn-images/property-photos/.../exterior-medium.webp",
      "seo_description": "Stunning mid-century estate with pool, hot tub, and mountain views.",
      "amenities": ["pool", "hot-tub", "outdoor-ceremony"],
      "url": "https://www.thewedstay.com/properties/california/palm-springs/palm-springs-wedding-estate-..."
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "eyJ...",
    "total_count": 42
  },
  "request_id": "req_abc123def456"
}

Step 3: Get venue details

Fetch full details for a specific venue including photos, amenities, and pricing.

Get venue details

curl -X GET "https://www.thewedstay.com/api/v1/venues/palm-springs-wedding-estate-with-retro-pool-vibes-hollywood-history-sleeps-12" \
  -H "Authorization: Bearer ws_live_..."

Step 4: Calculate pricing

Use the pricing calculator to estimate costs for a specific event.

Calculate pricing

curl -X GET "https://www.thewedstay.com/api/v1/venues/pricing?region=california&event_guests=80&nights=3&season=peak" \
  -H "Authorization: Bearer ws_live_..."

Next steps

Venue endpoints — Full search and filter reference
Vendor endpoints — Search wedding vendors
Pricing calculator — Detailed pricing API
Submit inquiries — Send booking requests
Error handling — Error codes and troubleshooting

Quickstart

Quickstart

Step 1: Get your API key

Step 2: Search venues

Step 3: Get venue details

Step 4: Calculate pricing

Next steps

On this page

Quickstart

Quickstart

Step 1: Get your API key

Step 2: Search venues

Step 3: Get venue details

Step 4: Calculate pricing

Next steps

On this page