Get booking!
APIs for managing reservations, including creating, updating, and canceling table bookings within the restaurant
Last updated
APIs for managing reservations, including creating, updating, and canceling table bookings within the restaurant
Last updated
ℹ️ 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
GET
/reservations
Retrieves a list of all reservations for the specified property (e.g., restaurant) using the property ID
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
GET
/reservations/{reservation_id}
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Response
POST
/reservations
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
POST
/reservations/google
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Body
enable_google_engine
boolean
Enable the google engine
Response
PUT
/reservations/{reservation_id}
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
PATCH
/reservations/{reservation_id}/checkin
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
PATCH
/reservations/{reservation_id}/checkout
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
PATCH
/reservations/{reservation_id}
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
/reservations/{reservation_id}
Headers
Content-Type
application/json
Authorization
Bearer <token>
Property
<your_property_id>
Response
Retrieves a reservations by its ID
Creates a new reservation for the specified property using the provided reservation details
Activates the Google Engine for a specified property
Update an existing reservation
Customers check-in
Customers check out
Update the status of the reservation in waiting list. If on the waiting list, the reservation should become accepted, declined, or confirmed
Delete a reservation