Skip to content
CibusyDevelopers
TREN
Get an API key

Venues

List tables

The venue's floors, terraces and rooms, each with its tables, in the order the venue's till shows them.

GET/public/v1/venues/{venueId}/tables
Authentication

An API key in the X-Api-Key header

Permission
Can read the menu (every key has it)
Rate limit
About 120 requests a minute per key

A dine-in order (DineIn) names one of these tables by its id. The till's order is kept: the tables the venue has arranged first, then the rest by name with the numbers read as numbers (T2 before T10).

Guide: Venues and branches

Parameters

venueIdstring · uuidPath parameterrequired

The venue's id, from the list of venues.

Accept-LanguagestringHeader

The language of userMessage in an error: tr (the default), en, de, fr, it, es, ar or ru. The first language in the header decides, without its region (en-US reads as en) and without weighing q values; a language Cibusy does not offer is answered in Turkish. It does not choose the language of a menu: that is lang on the menu call.

Responses

200

The venue's areas and their tables.

401

The X-Api-Key header is missing (PUBLIC_API_KEY_MISSING), or the key is invalid or has been revoked (PUBLIC_API_KEY_INVALID).

403

The key may not make this call (PUBLIC_API_SCOPE_MISSING). Every key made in the venue's panel may read venues, menus and tables.

404

The venue does not exist, or this key cannot reach it (PUBLIC_API_VENUE_NOT_FOUND).

429

The key's budget of about 120 requests a minute is spent; wait Retry-After seconds.

Retry-After

Seconds to wait. The next one-minute window opens within it.

The data of a successful answer: an array of these

A floor, terrace or room of a venue, and the tables on it. A dine-in order names one of the tables.

idstring · uuid

The area's id.

namestring

The area's name.

displayOrderinteger

The area's position among the venue's areas, lowest first. The areas come already in this order.

tablesobject[]

The area's tables, in the order the venue's till shows them: the ones the venue has arranged first, then the rest by name with the numbers read as numbers (T2 before T10). Empty for an area with no tables yet.

Fields of Table
idstring · uuid

The table's id, the one a dine-in order names.

namestring

The table's name as it is written on the till.

codestringnullable

The code printed on the table's QR card. null for a table that has none.

capacityintegernullable

How many people the table seats. null when the venue has not said.