# Request for API Endpoint to Fetch Live Waiting Customers in Queue

**URL:** <https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586>\
**Category:** API and Webhooks\
**Tags:** webhooks, api, sdk\
**Created:** [January 30, 2026, 10:21am UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586 "2026-01-30T10:21:58Z")\
**Posts on this page:** 15\
**Page:** 1

<div class="post-metadata">

**Author:** ![Srinath](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/srinath/32/68585_2.png) [@Srinath](https://devforum.zoom.us/u/Srinath)\
**Post date:** [January 30, 2026, 10:21am UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/1 "2026-01-30T10:21:58Z")

</div>

Hi Team,

I hope you are doing well.

I am currently working on a custom reporting solution using business intelligence tools such as Power BI and Grafana. I have successfully implemented several KPI cards for Call Overview, Agent Status, and Service Levels using the available Zoom Contact Center APIs.

However, I was unable to find the API endpoint that provides live waiting customers in queue (i.e., the count or details of callers currently waiting in queue). I have searched through the Zoom API documentation and the Zoom Developer Forum but couldn’t locate any relevant information.

Please help me with the correct API endpoint (or any workaround) to fetch live waiting queue data. Any guidance on retrieving real-time queue wait metrics would be greatly appreciated.

Thank you in advance for your help!

Regards,  
Srinath Venkatesan

---

<div class="post-metadata">

**Author:** ![expertswho](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/expertswho/32/60945_2.png) [@expertswho](https://devforum.zoom.us/u/expertswho)\
**Post date:** [January 31, 2026, 6:46pm UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/2 "2026-01-31T18:46:41Z")

</div>

hi @Srinath ,

I dont have a full answer, but I would be looking for webhooks.

hope that helps

John

---

<div class="post-metadata">

**Author:** ![Srinath](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/srinath/32/68585_2.png) [@Srinath](https://devforum.zoom.us/u/Srinath)\
**Post date:** [February 1, 2026, 5:49pm UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/3 "2026-02-01T17:49:02Z")

</div>

Hi John,

Thanks for your response. Please let me know if you have any updates or further guidance on this.

Regards,  
Srinath

---

<div class="post-metadata">

**Author:** ![elisa.zoom](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/elisa.zoom/32/47836_2.png) [@elisa.zoom](https://devforum.zoom.us/u/elisa.zoom)\
**Post date:** [February 2, 2026, 8:30pm UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/4 "2026-02-02T20:30:42Z")

</div>

hi @Srinath  
Thanks for reaching out to us  
and just adding to @expertswho  
Have you reviewed some of our ZCC webhooks?[Contact Center Webhooks](https://developers.zoom.us/docs/api/contact-center/events/#tag/contact_center/postcontact_center.queue_agent_assigned)

---

<div class="post-metadata">

**Author:** ![Srinath](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/srinath/32/68585_2.png) [@Srinath](https://devforum.zoom.us/u/Srinath)\
**Post date:** [February 3, 2026, 3:17am UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/5 "2026-02-03T03:17:24Z")

</div>

Hi Elisa,  
Thanks for sharing. Yes, I’ve reviewed all the ZCC Contact Center webhooks and their response payloads, but I couldn’t find any webhook that provides live waiting customers or real-time queue details.  
Please let me know if I might have missed a specific event.  
Thanks,  
Srinath

---

<div class="post-metadata">

**Author:** ![expertswho](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/expertswho/32/60945_2.png) [@expertswho](https://devforum.zoom.us/u/expertswho)\
**Post date:** [February 3, 2026, 6:55pm UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/6 "2026-02-03T18:55:05Z")

</div>

hi @Srinath ,

As I understand youre question, I would suggest this  
[https://developers.zoom.us/docs/api/contact-center/#tag/queues/post/contact\_center/queues/{queueId}/scheduled\_callbacks/events](https://developers.zoom.us/docs/api/contact-center/#tag/queues/post/contact_center/queues/%7BqueueId%7D/scheduled_callbacks/events)

Please let us know if there is anything that this does not give.

all the best

John

---

<div class="post-metadata">

**Author:** ![Srinath](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/srinath/32/68585_2.png) [@Srinath](https://devforum.zoom.us/u/Srinath)\
**Post date:** [February 4, 2026, 4:53am UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/7 "2026-02-04T04:53:23Z")

</div>

Hi John,  
Thank you for sharing the scheduled callbacks API.  
We reviewed the endpoint you mentioned (`POST /contact_center/queues/{queueId}/scheduled_callbacks/events`) and noted that it is used to **create scheduled callbacks** , but it does not expose any metric or key related to **live waiting customers/calls** in the response payload.  
During our research, we found that under Contact Center APIs → Queue section, the **Get a Queue** endpoint returns the following fields:

- `waiting_room_name`

- `waiting_room_id`

Could you please advise if there is any API available to fetch **live waiting call/customer counts or details** using this `waiting_room_id` or `waiting_room_name`?  
Specifically, we are looking for an endpoint that provides **live waiting data** for queues (similar to live queue metrics).  
Please let us know if such an endpoint exists or if there is an alternative recommended approach.

---

<div class="post-metadata">

**Author:** ![expertswho](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/expertswho/32/60945_2.png) [@expertswho](https://devforum.zoom.us/u/expertswho)\
**Post date:** [February 4, 2026, 10:48am UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/8 "2026-02-04T10:48:48Z")

</div>

hi @Srinath ,

You want to use webhooks to receive notifications.

So, if you look at the contact centre

> **[Contact Center Webhooks](https://developers.zoom.us/docs/api/contact-center/events/)**
>
> The Zoom Contact Center webhooks allow developers to receive events for Contact Center features.

Then I will search/filter on queue?

 ![image](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/a/a/aa1b317861744d5309a08a55d1dc092a85d1187b.png)

I think the last two will help you?

All the best

John

---

<div class="post-metadata">

**Author:** ![Srinath](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/srinath/32/68585_2.png) [@Srinath](https://devforum.zoom.us/u/Srinath)\
**Post date:** [February 27, 2026, 4:39am UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/9 "2026-02-27T04:39:21Z")

</div>

Hi John,

Apologies for the delayed response — I was testing this thoroughly over the past few days before replying. Thank you again for guiding me earlier.

As you suggested, I checked the webhook events related to queue-waiting. However, during testing, I’m only receiving the waiting ID and waiting name for the in-app video queue. My specific requirement is to track **live waiting data for the Voice channel queue**.

During further research, I found the **List Engagements** endpoint under Engagements. In the payload, I can see parameters like:

 ![image](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/f/5/f5c31c4b524a6f351930f65f5ecb6f3258360362.png)

- `"queue_wait_type": "live_waiting"`
- `"waiting_duration": 49`

 ![image](https://us1.discourse-cdn.com/flex016/uploads/zoomdeveloper/original/3X/d/7/d7e4ec7d7cdf99ebcf6ea8759beb1404e3fa4bdf.png)

However, when testing this endpoint, I observed that the live waiting data does not appear while the customer is actively waiting in the voice queue. The data is only returned after the consumer hangs up — essentially behaving like historical data rather than real-time data.

My objective is to identify a **live endpoint or webhook** that provides real-time visibility into voice channel queue waiting — similar to how supervisors can monitor live waiting calls in Zoom Workplace.

Could you please help clarify if there is a supported way to retrieve real-time voice queue waiting data via API or webhook? Your guidance would be greatly appreciated, as this is critical for our use case.

Thank you in advance for your support.

Best regards,  
Srinath

---

<div class="post-metadata">

**Author:** ![Srinath](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/srinath/32/68585_2.png) [@Srinath](https://devforum.zoom.us/u/Srinath)\
**Post date:** [March 18, 2026, 3:04am UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/10 "2026-03-18T03:04:08Z")

</div>

Hi John,

I hope you’re doing well. Just following up on my previous message regarding the **real-time voice queue waiting data** via API/webhook.

I wanted to check if you had a chance to review this or if there are any updates on whether a **live endpoint or webhook** is available for this use case.

This is quite important for our implementation, so any guidance or direction would be greatly appreciated.

Looking forward to your response.

Best regards,  
Srinath

---

<div class="post-metadata">

**Author:** ![Srinath](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/srinath/32/68585_2.png) [@Srinath](https://devforum.zoom.us/u/Srinath)\
**Post date:** [March 18, 2026, 3:05am UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/11 "2026-03-18T03:05:32Z")

</div>

if this data is **not available/exposed from Zoom at the moment** , kindly help clarify that as well.

This will help us align our implementation accordingly.

Looking forward to your update.

---

<div class="post-metadata">

**Author:** ![Srinath](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/srinath/32/68585_2.png) [@Srinath](https://devforum.zoom.us/u/Srinath)\
**Post date:** [March 18, 2026, 11:07am UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/12 "2026-03-18T11:07:27Z")

</div>

Hi Team @expertswho @elisa.zoom ,

I hope you’re doing well. Just following up on my previous message regarding the **real-time voice queue waiting data** via API/webhook.

I wanted to check if you had a chance to review this or if there are any updates on whether a **live endpoint or webhook** is available for this use case.

This is quite important for our implementation, so any guidance or direction would be greatly appreciated.

if this data is **not available/exposed from Zoom at the moment** , kindly help clarify that as well.

This will help us align our implementation accordingly.

Looking forward to your response.

Best regards,  
Srinath

---

<div class="post-metadata">

**Author:** ![expertswho](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/expertswho/32/60945_2.png) [@expertswho](https://devforum.zoom.us/u/expertswho)\
**Post date:** [March 18, 2026, 10:21pm UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/13 "2026-03-18T22:21:38Z")

</div>

hi @Srinath ,  
I get an idea of your use case, but I think I have to agree that this is not possible with any of the calls we have. But my understanding of contact centre is not strong enough to help you any further.  
I would suggest you try to join one of the developers’ office hours, where we often have more Zoom Developer team members.

John

---

<div class="post-metadata">

**Author:** ![Srinath](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/srinath/32/68585_2.png) [@Srinath](https://devforum.zoom.us/u/Srinath)\
**Post date:** [March 19, 2026, 6:57am UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/14 "2026-03-19T06:57:00Z")

</div>

Hi @expertswho

Thank you for the clarification.

Could you please share the **registration link or any resources** to join the **developers’ office hours**? I’d like to connect with the team there and discuss this use case further.

Appreciate your support on this.

---

<div class="post-metadata">

**Author:** ![expertswho](https://sea2.discourse-cdn.com/flex016/user_avatar/devforum.zoom.us/expertswho/32/60945_2.png) [@expertswho](https://devforum.zoom.us/u/expertswho)\
**Post date:** [October 15, 2026, 9:43am UTC](https://devforum.zoom.us/t/request-for-api-endpoint-to-fetch-live-waiting-customers-in-queue/141586/15 "2026-10-15T09:43:15Z")

</div>

hi @Srinath ,

It is showing at the top of all the forum pages.

> **[Welcome! You are invited to join a meeting: Zoom SDK and API - Developer...](https://success.zoom.us/meeting/register/tJwsfuqtrT4oGddjsGBaUg2nZdXx4rWLzv1Z#/registration)**
>
> Welcome! You are invited to join a meeting: Zoom SDK and API - Developer Office Hours. After registering, you will receive a confirmation email about joining the meeting.

John
