Send a big-group enquiry
/api/book/{slug}/enquiriesWhat a guest sends when their party is larger than the venue's maxOnlinePartySize. It lands in the venue's dashboard inbox as a conversation the team can reply to.
Rate limited per visitor before the slug is even resolved, so it cannot be used to probe which venues exist.
A party at or below the ceiling is refused, and a venue that has set no ceiling refuses everything here: this is the way to a booking the venue wants to look at, not an open "email the business" box.
Path Parameters
The organization's public booking slug, i.e. the {slug} in /{slug}. Only orgs with status active resolve; anything else is a 404.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/book/string/enquiries" \ -H "Content-Type: application/json" \ -d '{ "partySize": 1, "name": "string", "email": "string", "phone": "string" }'{ "ok": true, "enquiryId": "aa5368aa-b8dc-438d-a60b-d04164139169"}Preview a promo codePOST
A preview, so a booking page can confirm a code and show its discount before the guest fills in their details. Never creates or charges anything: `POST /api/book/{slug}/appointments` checks the same code again under the same rules, and only that answer is ever charged. A "valid" preview can still be refused at checkout, for example a once-per-customer code the guest has already used, since this route has no customer to check yet. Rate limited on the tighter guest write budget, 30 requests a minute: a code is a short, guessable string, and this is the one endpoint that tests a guess without booking anything.
Join the waitlistPOST
What a guest leaves when a date came back with **no tables at all**. The entry lands on the venue's reservations screen. **Nothing is held or promised by joining.** The venue offers a table later if one frees up, and the guest books it through the ordinary flow; whoever gets there first gets it. Rate limited per visitor before the slug is resolved or the body is parsed, so it cannot be used to probe which venues exist. A party above the venue's `maxOnlinePartySize` is refused with `enquiryRequired`: send a group enquiry instead.