Get booking!
APIs for managing reservations, including creating, updating, and canceling table bookings within the restaurant
ℹ️ The Booking Engine is the core feature, allowing customers to make reservations, choose rooms, slot times, number of persons and cancel existing bookings. ⚙️ Use the base resource URL for the following examples, or see the complete collection
🔍 Find all reservations
GET
/reservations
Retrieves a list of all reservations for the specified property (e.g., restaurant) using the property ID see more
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Query params
next_cursor
string
Pagination cursor
limit
int
Elements limit per page
start_date
date [YYYY-MM-DD]
Start day of search
end_date
date [YYYY-MM-DD]
End day of search
status[]
[WAITING, ACCEPTED, CANCELLED, CONFIRMED, EXPIRED, PREPAY, OUTOFORDER, REJECTED]
The status of reservation
text_search
string
The text search by customer name, last name or phone number
service_ids[]
[int]
The id list of services
room_ids[]
[int]
The id list of rooms
Response
🔍 Find a reservation
GET
/reservations/{reservation_id}
Retrieves a reservations by its ID see more
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Response
🆕 Create a new reservation
POST
/reservations
Creates a new reservation for the specified property using the provided reservation details see more
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Body
start_date
date [YYYY-MM-DD]
The start date
start_hour
time [HH:mm:ss]
The start hour
pax
int
The number of person
channel
enum [OCTOTABLE_BOOK, OCTOTABLE_ADMIN]
OCTOTABLE_BOOK: This indicates reservations made through the Booking Engine. resents reservations made through Reserve with Google. OCTOTABLE_ADMIN: Refers to self reservations.
customer
Customer
The customer who makes the reservation
customer.first_name
string
The customers first name
customer.last_name
string
The customer last name
customer.email
string
The customers email
customer.phone
string
The customers phone
service_id
int
The id of the selected service
room_id
int
The id of the selected room
table_ids
[int]
The list of ids of the selected tables
waiting_list
boolean
Keep reservation in waiting list
Response
🟢 Enable Google Engine
POST
/reservations/google
Activates the Google Engine for a specified property see more
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Body
enable_google_engine
boolean
Enable the google engine
Response
🔄 Update a reservation
PUT
/reservations/{reservation_id}
Update an existing reservation see more
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Body
start_date
date [YYYY-MM-DD ]
The start day
start_hour
time [HH:mm:ss]
The start hour
pax
int
The number of person
service_id
int
The id of the selected service
room_id
int
The id of the selected room
table_ids
[int]
The list of ids of the selected tables
Response
🔄 Check in
PATCH
/reservations/{reservation_id}/checkin
Customers check-in see more
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Query params
undo
boolean
Undo check in if it has been made by mistake
Response
🔄 Check out
PATCH
/reservations/{reservation_id}/checkout
Customers check out see more
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Query param
undo
boolean
Undo check out if it has been made by mistake
Response
🔄 Update status
PATCH
/reservations/{reservation_id}
Update the status of the reservation in waiting list. If on the waiting list, the reservation should become accepted, declined, or confirmed see more
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Query param
status
enum
The status of the reservation in waiting list
Response
🗑️ Delete a reservation
DELETE
/reservations/{reservation_id}
Delete a reservation see more
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Response
Last updated