WedStay
info@thewedstay.com

Subscribe to our newsletter

For Everyone

  • About Us
  • How It Works
  • Download App
  • Blog
  • Reviews
  • FAQs
  • Terms
  • Privacy
  • Contact
  • We're Hiring!
  • Sitemap

For Couples

  • Wedding Venues
  • Wedding Venue Buyout
  • Wedding House Rentals
  • How WedStay Works
  • Wedding Venue Finder
  • Wedding Quizzes
  • Venue Style Quiz
  • How Venue Matcher Works
  • 2025 Wedding Trends
  • Viral Wedding Estates
  • Preferred Vendor Marketplace
  • Non-Traditional Weddings
  • Wedding Weekend Experience
  • Wedding Planning Checklist Tool
  • WedStay-Style Weddings
  • Venue 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 Wedstay Vendor Network
  • Preferred Vendor Marketplace
  • 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

    VenuesVendorsPricingInquiries

    Reference

    ErrorsRate Limits

    Integrations

    MCP ServerChatGPT Action

    Errors

    Error response format, error types, and HTTP status codes used by the WedStay API.

    Error Reference

    All API errors follow a consistent envelope format. Use the type and code fields for programmatic error handling, and message for display to users.

    Error format

    {
      "error": {
        "type": "invalid_request",
        "code": "missing_required_field",
        "message": "The 'guest_email' field is required.",
        "request_id": "req_abc123def456",
        "doc_url": "https://www.thewedstay.com/developers/errors#missing_required_field"
      }
    }
    FieldTypeDescription
    typestringError category (see table below)
    codestringSpecific error code for programmatic handling
    messagestringHuman-readable description
    request_idstringUnique request identifier for support
    doc_urlstringLink to relevant documentation

    Error types

    TypeHTTP StatusDescription
    invalid_request_error400The request was malformed or missing required fields
    validation_error400A field has an invalid value or failed validation
    authentication_error401Invalid, missing, or expired API key
    not_found404The requested resource does not exist
    rate_limit_exceeded429Too many requests — slow down
    internal_error500Something went wrong on our end

    Error codes

    invalid_request_error (400)

    CodeDescription
    missing_required_fieldA required field is missing from the request
    invalid_query_parameterAn unrecognized or malformed query parameter
    body_too_largeRequest body exceeds the 10KB limit
    invalid_jsonRequest body is not valid JSON

    validation_error (400)

    CodeDescription
    invalid_field_valueA field has an invalid value (e.g. negative guest count)
    invalid_date_formatDate field is not in ISO 8601 format
    invalid_regionThe pricing region is not recognized

    authentication_error (401)

    CodeDescription
    missing_api_keyNo Authorization header or X-WedStay-Key header provided
    invalid_api_keyThe API key is not valid or has been revoked

    not_found (404)

    CodeDescription
    venue_not_foundNo venue exists with the given slug or ID
    vendor_not_foundNo vendor exists with the given slug or ID
    endpoint_not_foundThe API endpoint does not exist

    rate_limit_exceeded (429)

    CodeDescription
    too_many_requestsYou've exceeded the per-minute rate limit
    daily_limit_exceededYou've exceeded the daily request limit

    internal_error (500)

    CodeDescription
    server_errorAn unexpected error occurred — contact support if persistent
    service_unavailableA downstream service is temporarily unavailable

    HTTP status codes

    StatusMeaning
    200Success
    201Created (inquiry submitted)
    400Bad request
    401Unauthorized
    403Forbidden
    404Not found
    429Rate limited
    500Internal server error

    Handling errors

    const response = await fetch('https://www.thewedstay.com/api/v1/venues', {
      headers: { Authorization: 'Bearer ws_live_...' },
    })
     
    if (!response.ok) {
      const { error } = await response.json()
     
      switch (error.type) {
        case 'rate_limit_exceeded':
          // Wait and retry
          const retryAfter = response.headers.get('Retry-After')
          break
        case 'authentication_error':
          // Check your API key
          break
        default:
          console.error(`API error: ${error.code} - ${error.message}`)
      }
    }

    Previous

    Inquiries

    Next

    Rate Limits

    On this page

    Error ReferenceError formatError typesError codesinvalid_request_error (400)validation_error (400)authentication_error (401)not_found (404)rate_limit_exceeded (429)internal_error (500)HTTP status codesHandling errors