Use queue APIs
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.