Skip to main content

List tables

Returns every table in the venue. Call this once per venue at onboarding to learn the venue's tables, then store the (id, name) pairs. Encode id in your QR codes and use it as {tableId} on the bill endpoint.

GET /v1/pat/venue/{venueId}/tables
Authorization: Bearer <token>

Path parameters

NameTypeNotes
venueIdstringMozrest venue identifier (must be in token scope)

Response - 200 OK

{
"venueId": "651f2c781027817e9f28e465",
"tables": [
{ "id": "8180b94f-e6ef-47b6-9d38-47b3459d06c9", "name": "T 1" },
{ "id": "01HXM-uuid-2", "name": "Window 7" },
{ "id": "01HXM-uuid-3", "name": "Bar 1" }
]
}
FieldNotes
idMozrest canonical table ID. Use this in QR codes and as {tableId} everywhere else.
nameHuman-readable label managed by the venue. May change without breaking the id.

Errors

StatusWhen
401 UnauthorizedToken invalid or revoked. OAuth-style body, not the standard envelope - see Errors
403 ForbiddenMissing Authorization header, token does not have partner access, or venue not in scope