WedStay
info@thewedstay.comGet the iOS App

Subscribe to our newsletter

By subscribing, you agree to receive emails and texts from WedStay. Unsubscribe anytime.

For Everyone

  • About Us
  • Is WedStay Legit?
  • How It Works
  • Download App
  • Blog
  • Reviews
  • FAQs
  • Terms
  • Privacy
  • Contact
  • We're Hiring!
  • Creator Program
  • Sitemap
  • Developers & API

For Couples

  • Wedding Venues
  • Wedding Venue Buyout
  • Wedding House Rentals
  • How WedStay Works
  • WedStay One Wedding Website
  • Wedding Venue Finder
  • Wedding Quizzes
  • Venue Style Quiz
  • How Venue Matcher Works
  • 2026 Wedding Trends
  • Viral Wedding Estates
  • Wedding Vendors
  • Wedding Inspiration
  • Non-Traditional Weddings
  • Wedding Weekend Experience
  • Wedding Planning Checklist Tool
  • Planning Tools
  • WedStay-Style Weddings
  • Venue Cost Calculator
  • Wedding Weekend Cost Calculator
  • Wedding Financing

For Property Owners

  • Submit Your Property
  • Wedding Industry Insights
  • Revenue Opportunities
  • WedStay Operating System
  • Property Transformation
  • Effortless Hosting
  • Top Wedding Trends

For Vendors

  • Join The WedStay Collective
  • Wedding Vendors
  • Wedding Photographers
  • The Ultimate Wedding Vendor Guide: A Former Bride's Tell-All

© 2026 WedStay. All rights reserved.

This site is not affiliated with or endorsed by Airbnb.

    WedStay Developers
    WedStay Developers
    API Referencethewedstay.com

    Getting Started

    WedStay APIQuickstart

    Endpoints

    VenuesVendorsPricingBlogInquiries

    Reference

    ErrorsRate LimitsChangelog

    Integrations

    MCP ServerChatGPT ActionBuilding AI-Powered Widgets

    Pricing

    Calculate wedding venue pricing with WedStay's transparent pricing engine. Region, guest count, season, and venue type all factor in.

    Pricing Calculator

    WedStay is one of the only platforms with transparent venue pricing. Most wedding venues hide their costs; we show them upfront.

    The pricing calculator returns estimated totals and price ranges based on region, event size, season, and venue type.

    Calculate pricing

    GET /api/v1/venues/pricing

    Query parameters

    ParameterTypeRequiredDescription
    regionstringNoA region id from the list below, its name, or a common short form (case insensitive, e.g. california, TX, tuscany, Italy - Tuscany). Default: california. An unknown region returns a 400 that lists the valid ids; it never falls back to a generic estimate
    event_typestringNoweekday or weekend. Default: weekend
    event_guestsnumberNoNumber of event guests (1 to 500). Default: 100
    overnight_guestsnumberNoNumber of overnight guests (1 to 350). Default: 20
    nightsnumberNoNumber of nights (2 to 7). Default: 2
    venue_typestringNobarn, estate, resort, winery, garden, historic, ranch, villa. Default: estate
    seasonstringNopeak, shoulder, off. Default: peak

    Regions

    The canonical ids, generated from the pricing model (src/lib/pricing/regions.ts). The keyless /api/calculate-venue-price/v2 endpoint and the MCP calculate_pricing tool accept the same values.

    IdNameAlso accepted
    californiaCaliforniaca
    new-yorkNew Yorkny, new-york-state
    texasTexastx
    floridaFloridafl
    michiganMichiganmi
    coloradoColoradoco
    north-carolinaNorth Carolinanc
    tennesseeTennesseetn
    georgiaGeorgiaga
    utahUtahut
    new-jerseyNew Jerseynj
    massachusettsMassachusettsma
    pennsylvaniaPennsylvaniapa
    illinoisIllinoisil
    virginiaVirginiava
    washingtonWashingtonwa, washington-state
    arizonaArizonaaz
    oregonOregonor
    mexicoMexicomx, tulum, cabo, los-cabos, cabo-san-lucas, riviera-maya, cancun, san-miguel-de-allende
    italyItalyit
    italy-tuscanyItaly - Tuscanytuscany, tuscany-italy
    italy-lake-comoItaly - Lake Comolake-como, como, lake-como-italy
    italy-amalfi-coastItaly - Amalfi Coastamalfi-coast, amalfi, amalfi-coast-italy
    italy-sicilyItaly - Sicilysicily, sicily-italy
    italy-pugliaItaly - Pugliapuglia, apulia, puglia-italy
    italy-umbriaItaly - Umbriaumbria, umbria-italy
    italy-romeItaly - Romerome, rome-italy
    italy-florenceItaly - Florenceflorence, florence-italy
    italy-veniceItaly - Venicevenice, venice-italy
    australiaAustraliaau
    otherOtherOnly by its id: a modelled national average for places outside this list

    Any other value, such as costa-rica or ireland, is an error: WedStay holds no regional model for it. For a specific venue anywhere, use the MCP calculate_pricing tool with the venue's slug, which prices that venue with its own pricing.

    Venue types: barn, estate, resort, winery, garden, historic, ranch, villa

    Seasons: peak (May to Oct), shoulder (Mar to Apr, Nov), off (Dec to Feb)

    Example request

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

    Example response

    {
      "data": {
        "estimated_total": 18172,
        "price_range": "$16,172 - $21,172",
        "per_night_average": 6057,
        "per_night": 6057,
        "summary": "Estimated $18,172 for 80 guests, 30 overnight, 3 nights at a estate & manor in California (peak season). Save ~31% vs traditional venue + hotels.",
        "savings_vs_traditional": {
          "savings_percent": 31,
          "note": "Based on average California traditional venue cost plus hotel rooms for 30 overnight guests across 3 nights."
        },
        "parameters": {
          "region": "California",
          "region_id": "california",
          "event_type": "weekend",
          "event_guests": 80,
          "overnight_guests": 30,
          "nights": 3,
          "venue_type": "estate",
          "venue_type_label": "Estate & Manor",
          "season": "peak"
        }
      },
      "request_id": "req_abc123def456"
    }

    Pricing notes

    • All amounts are in USD
    • estimated_total is the all-in estimate for the whole stay (base, guests, extra nights, cleaning, service fee and tax); price_range shows the realistic range around it
    • per_night_average is estimated_total divided by nights: an average for comparison, not a nightly rate any venue charges. per_night is a deprecated alias with the same value, kept until 2027-01-06
    • Estimates are based on regional data; actual pricing varies by property
    • The savings_vs_traditional field shows estimated savings vs. a traditional wedding venue in the same region, or null where no baseline is authored
    • For a specific venue, the pricing object on the venue endpoints is the venue page's own figure, and the inquiry endpoint gets a precise quote

    How WedStay pricing works

    Each WedStay venue has a base price for exclusive use of the entire property that covers its minimum stay (usually 2 nights; 3 to 5 at some properties), plus a lower price for each extra night. It is not a nightly rate. This means:

    1. No per-head pricing: You rent the whole property, not individual seats
    2. Multi-day stays: Most weddings are 2-3 night stays (rehearsal, wedding, brunch)
    3. Transparent: The price you see is the price you pay, plus cleaning and service fees
    4. Savings: Couples typically save 40-60% compared to traditional venues

    Previous

    Vendors

    Next

    Blog

    On this page

    Pricing CalculatorCalculate pricingQuery parametersRegionsExample requestExample responsePricing notesHow WedStay pricing works