Skip to content

Seat a walk-in at a table (API key, POS)

post/api/v1/walk-ins

For a till opening a check on a table nobody booked. The party is seated now, with no guest attached, and shows on the Floor view like a host's quick-seat; post the check total against the returned id with POST /api/v1/reservations/{id}/checks, and finish it with /status. The online booking rules (booking window, online party limit, booking pauses) do not apply, because the party is already in the room; the venue's own seating-capacity setting and the date's floor layout do. No email is sent. The booking's source is api.

Idempotency-Key header required: a UUID you generate once per booking attempt and resend unchanged on every retry. The first answer is stored and every retry with the same key, from the same API key, with the same body gets that answer back, so a retried create never books twice. The same UUID with a different body, or from a different API key, is a 409. Stored answers include refusals: a 409 for a taken time replays as a 409, so a new attempt needs a new key. Answers are kept for at least a day.

Authorization

bearerApiKey reservations:write
AuthorizationBearer <token>

Build with a test key (sk_test_...): it works only in your API sandbox and never emails or texts anyone. Scopes, errors and limits.

In: header

Scope: reservations:write

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/walk-ins" \  -H "Content-Type: application/json" \  -d '{    "partySize": 1,    "tableId": "073fbfcb-cd05-4203-be18-a1ce6f8e4d2d"  }'
{  "data": {}}