Retrieve the list of all appointments in queue

Purpose: Use this API to list all the appointments in your queue.

You must specify center_id to list all the appointments in a queue for a center. Optionally, you can also add guest_id to show all the appointments in queue for a guest of a center.

Example: GET: http://{apiurl}/v1/queue?CenterId={center_id}&GuestId={guest_id}

Response Object

NameTypeDescription
queueobjectObject containing the information of the appointments in queue.
guestobjectObject containing the information of the guests whose appointments are in the queue.
employeeobjectObject containing the information of the employees who have scheduled appointments in the queue.

queue Object

NameTypeDescription
orderintDenotes the order of the appointment in the queue.
preferred_timedate & timeDenotes the date and time of the appointment in the queue.
wait_time_in_minintDenotes the waiting time for the guest.
appointmentobjectObject containing the appointment details in the queue.
serviceobjectObject containing the service details.
guestobjectObject containing the guest details.
employeeobjectObject containing the employee details who is providing the serivce.

appointment Object

NameTypeDescription
ididUnique identifier of the appointment.
parent_ididUnique identifier of the parent appointment.
booking_typestringDenotes the type of booking.
group_idguidUnique identifier of the group appointment.
group_invoice_idguidUnique identifier of the invoice of the group appointment.
statusintStatus of the appointment.
sourceintThe referral source of the appointment in the queue.
progressintDenotes the progress of the appointment in the queue.
notesstringNotes of the appointment.
invoice_idguidUnique identifier of the invoice.
pricenumDenotes the price to be paid by the guest.
is_price_paidboolDenotes if the price is already paid by the guest.
start_time_in_centerdate & timeDenotes the start time of the appointment in the center.
end_time_in_centerdate & timeDenotes the end time of the appointment in the center.
checkin_time_in_centerdate & timeDenotes the check-in time of the stylist/therapist at the center.
actual_completed_time_in_centerdate & timeDenotes the appointment completed time.
actual_start_time_in_centerdate & timeDenotes the appointment start time.

service Object

NameTypeDescription
idguidUnique identifier of the service.
namestringName of the service.
durationintDuration of the service.
category_idguidUnique identifier of the service category.
is_addOnboolDenotes if the service is an add-on. True: The service is an add-on. False: The service is not an add-on.
has_addOnsboolIndicates if the service has any add-ons. True: The service has add-ons associated with it. False: The service does not have any associated add-ons.

guest Object

NameTypeDescription
idguidUnique identifier of the guest.
first_namestringFirst name of the guest.
last_namestringLast name of the guest.
phonestringPhone number of the guest.
emailstringEmail address of the guest.

employee Object

NameTypeDescription
idguidUnique identifier of the employee who is providing the service to the guest.
display_namestringName of the employee that is shown on the queue.
genderstringGender of the employee (stylist/therapist) M: Male, F: Female.
nick_namestringNick name of the employee as per the employee profile in Zenoti.
full_namestringFull name of the employee as per the employee profile in Zenoti.
first_namestringFirst name of the employee as per the employee profile in Zenoti.
last_namestringLast name of the employee as per the employee profile in Zenoti.
preference_typestringDenotes if the employee is preferred for "Any", "Specific", "Male" or "Female".

error Object

MessageCodeDescription
Invalid CenterIdQA014This message appears when no center_id is provided.
Invalid CenterIdQA014This message appears when the center_id is invalid.
Language
Credentials
Header
Click Try It! to start a request and see the response here!