đĒManage your tables and booking components
Follow this steps to know how does it work to create tables in OctoTable
âšī¸ A table is an entity used within a room to accommodate guests. A room component is an entity used within a room to accommodate guests. Components can include tables, sunbeds, armchair, beach umbrella, etc.
âī¸ Use the base resource URL for the following examples, or see the complete collection
https://api.octorate.com/octotable-pms/api/v2đ Find all tables
GET /room/{room_id}/tables
Retrieves a list of available tables for the specified property (e.g., restaurant) see more
To find all the table of a specific Room, you need to change the {room_id} parameter to the ID of the Room that was previously created.
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Response
{
"data": [
{
"id": 148129,
"name": "Table 1",
"bookable": true,
"free": true,
"group": false,
"guests_min": 1,
"guests_max": 4,
"room_id": 18802
},
{
"id": 148130,
"name": "Table 2",
"bookable": true,
"free": true,
"group": false,
"guests_min": 1
"guests_max": 2,
"room_id": 18802
}
]
}đ Find a table
GET /room/{room_id}/table/{table_id}
Retrieves details of a specific table for the given property using the table ID see more
To find tables of different Rooms, you need to change the {room_id} parameter to the ID of the Room that was previously created.
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Response
{
"data": [
{
"id": 148129,
"name": "Table 1",
"bookable": true,
"free": true,
"group": false,
"guests_min": 1,
"guests_max": 4,
"room_id": 18802
}
]
}đ Create a new table
POST /room/{room_id}/table
Creates a new table for the specified property using the provided table details see more
To create a table in different Rooms, you need to change the {room_id} parameter to the ID of the Room that was previously created.
â ī¸ Reserve with Google updates could take up to 24 hours to process.
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Body
name
string
Name of the table
bookable
boolean
Indicates whether a table can be booked online. When set to true, the table is available for online reservations. If set to false, the table can only be booked offline, such as by phone or in-person.
free
boolean
This status indicates that a table is available for a new reservation and is linked to the average meal duration. It means enough time has passed or is available based on the expected meal duration, making the table ready for the next booking
group
boolean
This concept refers to the ability to combine multiple tables to accommodate larger parties.
guest_min
int
The smallest number of people a table can seat. It prevents the table from being reserved for groups smaller than this number,
guest_max
int
The largest number of people a table can seat. This limit ensures that a table is not booked for groups exceeding its seating capacity,
Response
{
"data": [
{
"id": 148129,
"name": "Table 1",
"bookable": true,
"free": true,
"group": false,
"guests_min": 1,
"guests_max": 4,
"room_id": 18802
}
]
}đ Update a table
PUT /room/{room_id}/table/{table_id}
Updates the table for the specified property using the provided table details see more
To update data of Rooms, you need to change the {room_id} parameter to the ID of the Room that was previously created.
â ī¸ Reserve with Google updates could take up to 24 hours to process.
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Body
name
string
Name of the table
bookable
boolean
Indicates whether a table can be booked online. When set to true, the table is available for online reservations. If set to false, the table can only be booked offline through self reservations, such as by phone or in-person.
free
boolean
This status indicates that a table is available for a new reservation and is linked to the average meal duration. It means enough time has passed or is available based on the expected meal duration, making the table ready for the next booking
group
boolean
This concept refers to the ability to combine multiple tables to accommodate larger parties.
guest_min
int
The smallest number of people a table can seat. It prevents the table from being reserved for groups smaller than this number.
guest_min
int
The largest number of people a table can seat. This limit ensures that a table is not booked for groups exceeding its seating capacity.
Response
{
"data": [
{
"id": 148129,
"name": "Table 1",
"bookable": true,
"free": true,
"group": false,
"guests_min": 1,
"guests_max": 4,
"room_id": 18802
}
]
}đī¸ Delete a table
DELETE /room/{room_id}/table/{table_id}
Deletes an existing table from the specified property using the table ID see more
To delete a table of different Rooms, you need to change the {room_id} parameter to the ID of the Room that was previously created.
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Response
{
"data": [
21294
]
}đ ADDITIONAL NOTES Free: This status signifies that a table is available for reservation, directly tied to the average meal duration set by the restaurant. It indicates that either the previous reservation has finished and sufficient time has passed, or the expected duration of a meal allows the table to be ready for another booking. This ensures the table can be booked without overlapping existing reservations and maintains a smooth transition between customers. Example: If a restaurant has an average meal duration (average_stay take a look to Services section) of 90 minutes and a table is booked from 6:00 PM to 7:30 PM, the table's status will change to Free at 7:30 PM. This means it is now available for a new reservation starting from that time. The system uses this average meal duration to determine when a table becomes available again, helping to manage bookings efficiently and avoid scheduling conflicts.
Group tables: This feature allows you to combine smaller tables to accommodate larger groups. When creating a group table, you must specify the minimum and maximum number of guests that the grouped tables can accommodate. Itâs important to note that grouping tables does not increase the overall availability of the restaurant, as the same number of seats is being usedâonly distributed across different tables. Additionally, you can choose which tables to group based on their proximity, as some tables may be closer to each other, while others may be in different sections of the restaurant.
Example: A restaurant has tables for 2, 4, and 6 people. If a group of 8 wants to book, the user can group two tables for 4, as long as they are close to each other, or combine a table for 2 and a table for 6 if they are near each other. When creating the group table, the user specifies that the minimum and maximum guest numbers are 8, ensuring the reservation is handled correctly. The availability of the restaurant remains unchanged, as the group table simply combines existing tables.
Last updated