I’m encountering inconsistencies between the Zoom API documentation and the actual behavior of the GET /meetings/{meetingId}/registrants endpoint.
According to the Zoom API documentation, the endpoint should support pagination using next_page_token and return registrants across all statuses. However, in practice, I’ve observed two issues:
1. Pagination Behavior
-
Documentation claim:
The response should include anext_page_tokenfor pagination. -
Observed behavior:
Thenext_page_tokenfield is missing from the response.
I need to manually iterate using thepage_numberparameter to retrieve additional pages.
Example response snippet:
{
"page_count": 2,
"page_number": 1,
"page_size": 30,
"total_records": 49,
"registrants": [
{
"id": "REDACTED_ID_1",
"first_name": "Registrant 1",
"email": "user1@example.com",
"status": "approved",
"create_time": "2025-12-04T19:27:56Z",
"join_url": "https://example.zoom.us/w/86069748282?tk=REDACTED"
},
{
"id": "REDACTED_ID_2",
"first_name": "Registrant 2",
"email": "user2@example.com",
"status": "approved",
"create_time": "2025-12-04T19:06:09Z",
"join_url": "https://example.zoom.us/w/86069748282?tk=REDACTED"
}
]
}
2. Status Filtering Limitation
- Observed limitation:
The API only returns registrants for a single status type (approved,pending, orcancelled) per request.
There’s no supported parameter or way to retrieve all registrants across all statuses in a single API call.
Example scenario:
-
A meeting has 52 total registrants
-
49 approved
-
2 cancelled
-
-
The endpoint only returns the registrants for the requested
status, e.g.,-
status=approved→ 49 registrants -
status=cancelled→ 2 registrants
-
-
There’s no way to get all 52 in one query.
Request for Clarification
-
Is the missing
next_page_tokena known issue or deprecated behavior for this endpoint? -
Is there an alternative endpoint or supported approach to fetch all registrants (approved, pending, and cancelled) for a specific meeting occurrence in a single request?
If not, could this functionality be considered for inclusion in a future API update, given its common use case for registration synchronization and analytics?
Environment:
-
App Type: Account-level Server-to-Server OAuth
-
Endpoint:
GET /meetings/{meetingId}/registrants -
Zoom API Version: v2
