API Endpoint(s) and/or Zoom API Event(s)
Dashboards /metrics/meetings/<>/participants/<>/qos
Description On occasions, I get below error for the above API when executed after getting the “meeting.ended” event notification with mentioned meeding-id.
Please note, I am using “id” parameter from the meeting.ended event and not “uuid”. From the document I see that we can use either “id” or “uuid”, if I’m not wrong.
Do I have to wait for a some X seconds after the event to get data consistently? Any constraints in using “id” instead of “uuid” as the meeting id from meeting.ended event?
Error?
{code=3001, message=Meeting does not exist: 85027654487.}
How To Reproduce Steps to reproduce the behavior:
Onboard a Zoom account having multiple users to a General App in marketplace
Complete the OAuth process to get access token to execute the above mentioned APIs
Subscribe to meeting.ended events
Start a meeting from user1 and let user2 join the meeting through the zoom link. And then end the call after 4-5 mins
meeting.ended event is received at the webhook callback URL with meeting id. I pick the “id” parameter from this.
Using this meeting id “id”, call v2/metrics/meetings/85027654487/participants?type=past and get the list of participants details (Please note, this API works fine with same meeting id)
Using “user_id” from above participants response, call v2/metrics/meetings/85027654487/participants/16778240/qos?type=past. Now I get error code: 3001 response.
Hi @ucczoomaruba
thanks for reaching out to us!
I have been looking into this and doing some testing on my end and it looks like, this API will not return data if there is no data being sent or received at the time of the request.
So my question is if you have seen this with meetings where the participant you are trying to query, did no turn on their camera or did not unmute during the meeting. If this is not the case, I am happy to investigate this further.
I would just need an entire request URL including the meeting Id and participant Id, as well as the tracking ID found in the response headers
Hi @elisa.zoom Thanks for getting back on this query.
Well, I would have to test again to confirm whether the camera/MIC was turned on or not. I will get back soon on this.
However, considering the camera/MIC wasn’t on, the API should not ideally return as "3001: Meeting not found’ if the QoS data is not found for the participant, because that would be misleading. It should instead return just the empty QoS data in the response.
Please let me know your thoughts on this.
Hey @ucczoomaruba
Can you make sure that you are passing the query parameter type=past in your request please?
I noticed that when I do not pass this query param, I get an error
Hi @elisa.zoom
Yes, I am sure I am passing the type=past param in the API calls. It’s just that while copy-pasting details here in forum, I removed it.
Hi @elisa.zoom
I have some more information to share here.
Issue of return code of 3001: “Meeting does not exist” was seen again today while testing between my laptop client (6.3.11.60501) and iPhone client (6.2.5.18677).
At 2025-07-23T06:39:33.791865069Z I received meeting.ended event
{
"event":"meeting.ended",
"payload":{
"account_id":"MASK",
"object":{
"duration":0,
"start_time":"2025-07-23T06:36:18Z",
"timezone":"",
"end_time":"2025-07-23T06:39:09Z",
"topic":"zoom ucc’s Zoom Meeting",
"id":"85490232132",
"type":1,
"uuid":"FHytJN8XSjm5PNN8nowECg==",
"host_id":"MASK"
}
},
"event_ts":1753252749726
}
One more thing to note is that when I tried meetings between 2 laptop clients, I didn’t see this 3001 code issue.
Please check and let me know the following:
Is the issue related to or dependent on client being used in mobile/iPhone?
Is it a valid use case between laptop and mobile?
If so, do we have to wait for few seconds between receiving the meeting ended event & subsequent metrics/meetings/<>/participants/ API calls?
Do we have any settings to enable mobile usage (Products or Surfaces?) in the marketplace app which I am using for onboarding the Zoom account having these users?
Hi @ucczoomaruba
Thank you so much for all these details!
To answer some of your questions, I want to start addressing the issue that you have to wait a few seconds between receiving the meeting ended event and the calls to metrics endpoints, and yes this is a known behavior. Since our metric endpoints pull a lot of data and they are resource-intensive APIs, it takes a couple of seconds for our backend to sync. I apologize I did not start by mentioning this in my initial reply. I was initially thinking that this was an issue related to the way you were querying the endpoint (query params and whatnot)
I am not aware of this issue being related to the client being used on a mobile device. Have you noticed that if you query this endpoint right after receiving the event, you won’t get the error only if the meetings are being held in laptops?