API Documentation

Vegas Guest List Access Public APIs

These endpoints support public site functions for health checks, free guestlist signup or table requests, and site question search. The POST endpoints are intended for same-site usage and reject requests that do not originate from the site itself.

Discovery resources: API catalog, OpenAPI description, security.txt

GET /api/health

Simple health check endpoint used to confirm that the Cloudflare worker is running.

{
  "ok": true
}

POST /api/guestlist-request

Accepts a guestlist or table request payload from the public form and forwards it through the configured Google Workspace mail delivery path.

Content-Type: application/json

Required fields:

• venue: XS Nightclub, Encore Beach Club, or Encore Beach Club At Night
• requestType: guestlist or table
• firstName, lastName
• dateAttending in YYYY-MM-DD format
• womenCount, menCount as integers 0 or greater
• email, phone

Optional fields: notes, website, formStartedAt, capturedAt

POST /api/testimonial-submission

Accepts a testimonial submission for manual review, saves it into the private pending-review queue, stores the uploaded review image, and can email the site owner a review notification with an image link.

Content-Type: multipart/form-data

Required fields:

• guestName
• venueFocus: XS Nightclub, Encore Beach Club, Encore Beach at Night, or Still comparing venues
• testimonialMessage (up to 3000 characters)

Optional field: testimonialPhoto as a verified image upload.

GET /api/testimonial-review-image

Opens a private pending-review image link from the testimonial review email. This endpoint is meant for owner review access and uses the pending testimonial ID plus a private token from the email.

Required query parameters: id, token

POST /api/ai-search

Runs the public site question search against the configured Cloudflare AI Search instance and returns a concise answer plus up to four source snippets for guestlist, no cover entry, and venue-planning questions.

Content-Type: application/json

Required field: query (minimum 6 characters)