Submit venue booking requests and vendor contact inquiries through the WedStay API.

Inquiry Endpoints

Submit booking requests to venues and contact inquiries to vendors. These create real leads that property owners and vendors respond to within 24-48 hours.

Submit venue inquiry

POST /api/v1/inquiries/venue

Submit a booking request to a specific venue. The property owner will be notified immediately.

Request body

Field	Type	Required	Description
`property_slug`	string	Yes	The venue's URL slug (from search results)
`start_date`	string	Yes	Check-in date (ISO 8601: `2026-09-19`)
`end_date`	string	Yes	Check-out date (ISO 8601: `2026-09-22`)
`event_guests`	number	Yes	Number of event guests
`overnight_guests`	number	No	Number of overnight guests
`guest_name`	string	Yes	Full name of the person inquiring
`guest_email`	string	Yes	Contact email address
`guest_phone`	string	No	Contact phone number
`message`	string	No	Additional details or questions (max 5000 chars)

Example request

curl -X POST "https://www.thewedstay.com/api/v1/inquiries/venue" \
  -H "Authorization: Bearer ws_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "property_slug": "texas-wedding-village-...",
    "start_date": "2026-09-19",
    "end_date": "2026-09-22",
    "event_guests": 80,
    "overnight_guests": 30,
    "guest_name": "Sarah Johnson",
    "guest_email": "sarah@example.com",
    "guest_phone": "+1-555-0123",
    "message": "Looking for a weekend wedding with outdoor ceremony space."
  }'

Example response

{
  "data": {
    "inquiry_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "submitted",
    "message": "Your booking request has been submitted. A WedStay concierge will respond within 24 hours."
  },
  "request_id": "req_abc123def456"
}

Submit vendor inquiry

POST /api/v1/inquiries/vendor

Send a contact inquiry to a vendor. The vendor receives an email notification immediately.

Request body

Field	Type	Required	Description
`vendor_slug`	string	Yes	The vendor's URL slug (from search results)
`guest_name`	string	Yes	Full name of the person inquiring
`guest_email`	string	Yes	Contact email address
`guest_phone`	string	No	Contact phone number
`event_date`	string	No	Event date (ISO 8601: `2026-09-20`)
`event_location`	string	No	Where the event will be held
`event_guests`	number	No	Guest count
`budget_range`	string	No	Budget range (e.g. "$3000-$5000")
`service_needed`	string	No	Specific service needed
`message`	string	No	Details about what you need (max 5000 chars)

Example request

curl -X POST "https://www.thewedstay.com/api/v1/inquiries/vendor" \
  -H "Authorization: Bearer ws_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_slug": "golden-hour-studios",
    "guest_name": "Sarah Johnson",
    "guest_email": "sarah@example.com",
    "event_date": "2026-09-20",
    "event_location": "Canyon Lake, Texas",
    "message": "Need a photographer for a 3-day weekend wedding, 80 guests."
  }'

Example response

{
  "data": {
    "inquiry_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "submitted",
    "message": "Your vendor inquiry has been submitted. The vendor typically responds within 48 hours."
  },
  "request_id": "req_abc123def456"
}

Rate limits

Inquiry endpoints have stricter rate limits than read endpoints to prevent spam:

Tier	Venue inquiries	Vendor inquiries
Free	5 per day	5 per day
Pro	50 per day	50 per day

What happens after submission

The property owner or vendor receives an email notification immediately
WedStay's concierge team is also notified for quality assurance
Most inquiries receive a response within 24-48 hours
The inquiry appears in the owner/vendor's WedStay dashboard

Inquiry Endpoints

Submit booking requests to venues and contact inquiries to vendors. These create real leads that property owners and vendors respond to within 24-48 hours.

Submit venue inquiry

POST /api/v1/inquiries/venue

Submit a booking request to a specific venue. The property owner will be notified immediately.

Request body

Field	Type	Required	Description
`property_slug`	string	Yes	The venue's URL slug (from search results)
`start_date`	string	Yes	Check-in date (ISO 8601: `2026-09-19`)
`end_date`	string	Yes	Check-out date (ISO 8601: `2026-09-22`)
`event_guests`	number	Yes	Number of event guests
`overnight_guests`	number	No	Number of overnight guests
`guest_name`	string	Yes	Full name of the person inquiring
`guest_email`	string	Yes	Contact email address
`guest_phone`	string	No	Contact phone number
`message`	string	No	Additional details or questions (max 5000 chars)

Example request

curl -X POST "https://www.thewedstay.com/api/v1/inquiries/venue" \
  -H "Authorization: Bearer ws_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "property_slug": "texas-wedding-village-...",
    "start_date": "2026-09-19",
    "end_date": "2026-09-22",
    "event_guests": 80,
    "overnight_guests": 30,
    "guest_name": "Sarah Johnson",
    "guest_email": "sarah@example.com",
    "guest_phone": "+1-555-0123",
    "message": "Looking for a weekend wedding with outdoor ceremony space."
  }'

Example response

{
  "data": {
    "inquiry_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "submitted",
    "message": "Your booking request has been submitted. A WedStay concierge will respond within 24 hours."
  },
  "request_id": "req_abc123def456"
}

Submit vendor inquiry

POST /api/v1/inquiries/vendor

Send a contact inquiry to a vendor. The vendor receives an email notification immediately.

Request body

Field	Type	Required	Description
`vendor_slug`	string	Yes	The vendor's URL slug (from search results)
`guest_name`	string	Yes	Full name of the person inquiring
`guest_email`	string	Yes	Contact email address
`guest_phone`	string	No	Contact phone number
`event_date`	string	No	Event date (ISO 8601: `2026-09-20`)
`event_location`	string	No	Where the event will be held
`event_guests`	number	No	Guest count
`budget_range`	string	No	Budget range (e.g. "$3000-$5000")
`service_needed`	string	No	Specific service needed
`message`	string	No	Details about what you need (max 5000 chars)

Example request

curl -X POST "https://www.thewedstay.com/api/v1/inquiries/vendor" \
  -H "Authorization: Bearer ws_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_slug": "golden-hour-studios",
    "guest_name": "Sarah Johnson",
    "guest_email": "sarah@example.com",
    "event_date": "2026-09-20",
    "event_location": "Canyon Lake, Texas",
    "message": "Need a photographer for a 3-day weekend wedding, 80 guests."
  }'

Example response

{
  "data": {
    "inquiry_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "submitted",
    "message": "Your vendor inquiry has been submitted. The vendor typically responds within 48 hours."
  },
  "request_id": "req_abc123def456"
}

Rate limits

Inquiry endpoints have stricter rate limits than read endpoints to prevent spam:

Tier	Venue inquiries	Vendor inquiries
Free	5 per day	5 per day
Pro	50 per day	50 per day

What happens after submission

The property owner or vendor receives an email notification immediately
WedStay's concierge team is also notified for quality assurance
Most inquiries receive a response within 24-48 hours
The inquiry appears in the owner/vendor's WedStay dashboard

Inquiries

Inquiry Endpoints

Submit venue inquiry

Request body

Example request

Example response

Submit vendor inquiry

Request body

Example request

Example response

Rate limits

What happens after submission

On this page

Inquiries

Inquiry Endpoints

Submit venue inquiry

Request body

Example request

Example response

Submit vendor inquiry

Request body

Example request

Example response

Rate limits

What happens after submission

On this page