Preview a promo code or gift card against a held deposit
/api/book/{slug}/reservations/{id}/codesH12. Never applies or spends anything: what a promo code and/or gift card would do to the deposit or Experience ticket this hold owes, so the payment step can show the discount, the gift card part and what is left before the card is touched. The confirm (PATCH /api/book/{slug}/reservations/{id} with promoCode/giftCardCode) re-resolves the same codes with the guest's customer id and is the only place they are applied, so a once-per-customer or new-customers-only code can still be refused there. Stripe's minimum charge is respected: the card part is either 0 or at least the minimum. Rate-limited on the 'write' guest bucket.
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.
The reservationId returned by the hold.
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/reservations/string/codes" \ -H "Content-Type: application/json" \ -d '{}'{ "depositCents": 0, "promoDiscountCents": 0, "giftCardCents": 0, "giftCardBalanceCents": 0, "amountDueCents": 0}Release a held tableDELETE
The guest closed the sheet or hit back. Releases the table immediately rather than waiting out the hold window. Only ever deletes a row whose status is still `hold`; a confirmed booking is cancelled from the dashboard or the manage link, never dropped by an unauthenticated caller holding an id.
Place in the walk-in lineGET
One guest's status, by the token from joining. The token is the whole credential; an unknown one is a 404. `state` is `waiting` (with `position`, 1 is next, and `quotedMinutes` when the host quoted a wait), `ready` (come to the host stand), `seated`, `left` or `closed`. The status page polls this about every 20 seconds while visible.