Reserve a slot for a service booking

This API helps you to reserve a slot for the specified service booking (booking_id).

You can also use this API to reserve a slot for the required group service booking (booking_id).

You can choose a specific therapist or a therapist based on a certain gender while creating a service booking; after which, a unique 32-digit booking_id is generated.

You must then specify the generated booking_id in the API request. You can also provide appropriate details for the slot_time parameter in the API request body to reserve a slot for the service booking.

After you have reserved a slot for the service booking, you can then proceed to confirm the service booking.

This API also allows guests to reserve appointments for family members. Provided, there is a relationship defined in Zenoti and an appointment reservation can only be done by the host.

Request Body Details

NameTypeDescription
slot_timedatetimeDate and time of the service booking that is to be reserved.

Response Details

NameTypeDescription
is_reservedbooleanIndicates whether the service booking has been reserved.
reservation_idguidUnique 32-character identifier of the service booking reservation.
expiry_timedatetimeDate and time on which the service booking reservation will expire.
blocking_timeintegerBlock time of the reservation.
invoicesobjectObject that contains various invoice-related elements of the service booking. For more information, refer to the invoices Object table.
errorobjectObject that contains error message and error code details. For more information, refer to the error Object table.

invoices Object

NameTypeDescription
guestobjectObject that contains various guest-related elements of the service booking. For more information, refer to the guest Object table.
invoice_idguidUnique 32-character identifier of the invoice of the service booking.
itemsobjectObject that contains various item-related elements of the service booking. For more information, refer to the items Object table.

guest Object

NameTypeDescription
IdguidUnique 32-character identifier of the guest.
FirstNamestringFirst name of the guest.
LastNamestringLast name of the guest.

items Object

NameTypeDescription
itemobjectObject that contains various item-related elements included in the service booking. For more information, refer to the item Object table.
quantityintNumber of items included in the service booking.
therapistobjectObject that contains these therapist-related elements of the service booking: id, full_name, first_name, last_name, and nick_name.
roomobjectObject that contains these room-related elements of the service booking: id and name.
equipmentobjectObject that contains these equipment-related elements of the service booking: id and name.
start_timedatetimeStart date and time of the service booking session.
end_timedatetimeEnd date and time of the service booking session.
invoice_item_idguid?Unique 32-character identifier of the invoice item of the service booking.
appointment_idguid?Unique 32-character identifier of the reserved appointment booking.
addonslist?List of add-ons associated to the service booking.
package_serviceslist?List of package services associated to the service booking.

item Object

NameTypeDescription
idguidUnique 32-character identifier of the item included in the service booking.
namestringName of the item.
item_typeenumType of the item: 0 - Service, 2 - Product, 3 - Membership, 4 - Package, 6 - Giftcard, 7 - all.

error Object

codemessage
503Request is missing or id is missing.
502Could not get booking details.
502Invalid booking id.
502Slot is not available for reservation.
502Center not found.
502One or more services or addons are not available in the catalog.
502One or more therapists are not available in catalog.
Language
Authorization
Header
Click Try It! to start a request and see the response here!