Retrieve available slots for a service booking

This API helps you to retrieve available slots for the specified service booking (booking_id) on a given day. If no slots are available on that day, the API returns the next available slot on any other future day of the current week.

You can also use this API to retrieve available slots 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 as an input parameter in the API request body to retrieve available slots for the service booking.

Response Details

NameTypeDescription
slotsobjectObject that contains details about various elements about the slots on a day. For more information, refer to the slots table.
future_daysobjectObject that contains details about the availability of slots on a future day of the current week. For more information, refer to the future_days table.
next_available_daydatetimeThe latest day that contains available slots for the specified service booking.
ErrorobjectObject that contains error message and error code details. For more information, refer to the error table.

slots

NameTypeDescription
TimedatetimeThe time of a slot on any given day.
WarningsobjectObject that contains details about various warning elements of the slot. For more information, refer to the Warnings table.
PriorityintIndicates the priority of the slot.
AvailablebooleanIf true, it indicates that the slot is available to be booked for a service.
SalePricedecimalThe price of the service booking.

Warnings

NameTypeDescription
TypeenumIndicates the type of warning message for the slot: TherapistDoubleBooked = 0, TherapistOutsideSchedule = 1, GuestDoubleBooked = 2, RoomCapacityExceeded = 3, ServiceEndsOutsideCenterHours = 4, EquipmentCapacityExceeded = 5, DayIsHoliday = 6, TherapistDoubleSelcted = 7, RoomDoubleSelcted = 8, EquipmentDoubleSelcted = 9, TherapistNotAvailableOnReservation = 10, RoomNotAvailableOnReservation =11, and EquipmentNotAvailableOnReservation = 12.
MessagestringWarning message for the slot.
GuestIdguidUnique 32-character ID of the guest who will avail a service during the slot time period.
TherapistIdguidUnique 32-character ID of the therapist who will perform the service during the slot time period.
ServiceIdguidUnique 32-character ID of the service that the therapist will perform during the slot time period.
RoomIdguidUnique 32-character ID of the room in which the service will be performed during the slot time period.
EquipmentIdguidUnique 32-character ID of the equipment that will be used in the service during the slot time period.

future_days

NameTypeDescription
DaydatetimeDate and time details of an available slot in a future day of the current week.
IsAvailablebooleanIf true, it indicates that the slot is available to be booked for a service on that day.

Error

NameTypeDescription
StatusCodeintStatus code that represents the type of the error.
MessagestringMessage that describes the error.
InternalMessagestringInternal message that describes about the error in more detail.

Error Message Details

Error MessageError CodeDescription
id is missing.503If the booking ID is not specified.
Could not get booking details.502If the booking details could not be retrieved.
Invalid booking id.502If the specified booking ID is not valid.
Slot is not available for reservation.502If the slot is not available to be reserved for the appointment.
Center not found.502If the center details could not be retrieved.
One or more services or addons are not available in the catalog.502If certain services or add-ons are not available in the catalog.
One or more therapists are not available in catalog.502If certain therapists are not available in the catalog.
Language
Authorization
Header
Click Try It! to start a request and see the response here!