List Meetings

Use this API to list a user’s (meeting host) scheduled meetings. For user-level apps, pass the me value instead of the userId parameter.

Note:

• This API only supports scheduled meetings. This API does not return information about instant meetings.
• This API only returns a user’s unexpired meetings.

Scopes: meeting:read:admin, meeting:read Rate Limit Label: Medium.

External Documentation

To learn more, visit the Zoom documentation.

​

Basic Parameters

Parameter	Description
Page Size	The number of records returned within a single API call.
Return All Pages	Automatically fetch all resources, page by page.
Type	The type of meeting: * scheduled — All valid previous (unexpired) meetings, live meetings, and upcoming scheduled meetings. * live — All the ongoing meetings. * upcoming — All upcoming meetings, including live meetings. * upcoming_meetings — All upcoming meetings, including live meetings. * previous_meetings — All the previous meetings.
User ID	The user ID or email address of the user. For user-level apps, pass the me value.

​

Advanced Parameters

Parameter	Description
Next Page Token	The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.
Page Number	The page number of the current page in the returned records.

​

Example Output

{
	"page_size": 32,
	"total_records": 0,
	"next_page_token": "<string>",
	"meetings": []
}