Preview a promo code
/api/book/{slug}/promo-codes/validateA 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.
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
curl -X POST "https://example.com/api/book/string/promo-codes/validate" \ -H "Content-Type: application/json" \ -d '{ "code": "string", "serviceIds": [ "a486dd3f-c8ab-4226-b78c-e435f821cb91" ] }'{ "discountCents": 0}Book an appointmentPOST
Public guest checkout. The requested slot is checked again server-side (not in the past, inside the staff member's working hours, not inside a blocked period), because nothing stops a direct POST inventing a slot the booking page never offered. Overlap is enforced by the database. The client record is matched on email, so a returning customer builds up history on one record. `notes` goes on this booking, never on the client record. This route checks only that the business is active; it is the hospitality endpoints that refuse a business running the other engine.
Send a big-group enquiryPOST
What 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.