ZenotiHelp

Use queue APIs

ZTZenoti Docs Team Updated March 7, 2026 2 min readGuide

The queue APIs let you manage the guest queue at a center. Use these APIs to add guests to the queue, view current queue status with wait times, and retrieve available stylist wait times for walk-in scheduling.

For complete endpoint documentation including request/response schemas and code examples, see the individual API reference articles linked below.

Before you begin

  • You need a valid API key or access token. See Set up API authentication.
  • Queue functionality must be enabled for the center.

Permission: Manage API Keys (under Administrator) -- Required to access Zenoti APIs.

Add guests to the queue

POST /v1/queue/bookings

Adds a guest or group of guests to the queue for a center.

Parameter Type Required Description
guest_id guid Yes Guest identifier
center_id guid Yes Center identifier
service_id guid No Service the guest wants
stylist_id guid No Preferred stylist
time_slot datetime No Requested appointment time

Response: is_confirmed, invoice_id, appointment_group_id, bookings (array with id, first_name, last_name, wait_time_in_min, appointments with service and employee details).

Error codes: AA018 (guest does not exist), QA010 (slot is not available for reservation).

Retrieve the queue

GET /v1/queue

Retrieves all appointments currently in the queue for a center.

Parameter Type Required Description
CenterId guid Yes Center identifier
GuestId guid No Filter by specific guest

Response: queue (array with order (position in queue), preferred_time, wait_time_in_min, appointment details including status, price, is_price_paid, start_time_in_center, end_time_in_center, and associated service, guest, and employee information).

Error codes: QA014 (invalid center ID).

Fetch available stylist wait times

POST /v1/queue/available_times

Retrieves wait times for available stylists for a selected service in a center.

Parameter Type Required Description
center_id guid Yes Center identifier
service_id guid Yes Service identifier
online_hours boolean No Filter for online hours only

Response: available_times (array with employee details and start_time), first_available_times (earliest available slots), available_times_by_guest.

Error codes: GE437 (therapists not available), GE502 (invalid center ID).

Tips

  • Use the available stylist wait times endpoint to show guests estimated wait times before they join the queue.
  • Monitor queue positions in real time to update digital displays or guest notifications.
  • Combine queue APIs with guest APIs for a complete walk-in management workflow.

API reference

Was this article helpful?
Your feedback helps us improve our documentation.