Logo
Zoom Public API Documentation

List meetings

GET {{baseUrl}}/users/:userId/meetings?type=scheduled&page_size=30&next_page_token=IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2&page_number=1

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

 

Body PARAM

Key Datatype Required Description 
type
string 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.
page_size
number The number of records returned within a single API call.
next_page_token
string 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
number The page number of the current page in the returned records.



HEADERS

Key Datatype Required Description 
Accept
string




RESPONSES

status OK

{ "next_page_token": "Tva2CuIdTgsv8wAnhyAdU3m06Y2HuLQtlh3", "page_count": 1, "page_number": 1, "page_size": 30, "total_records": 1, "meetings": [ { "agenda": "My Meeting", "created_at": "2022-03-23T05:31:16Z", "duration": 60, "host_id": "30R7kT7bTIKSNUFEuH_Qlg", "id": 97763643886, "join_url": "https://example.com/j/11111", "pmi": "97891943927", "start_time": "2022-03-23T06:00:00Z", "timezone": "America/Los_Angeles", "topic": "My Meeting", "type": 2, "uuid": "aDYlohsHRtCd4ii1uC2+hA==" }, { "agenda": "My Meeting", "created_at": "2022-03-23T05:31:16Z", "duration": 60, "host_id": "30R7kT7bTIKSNUFEuH_Qlg", "id": 97763643886, "join_url": "https://example.com/j/11111", "pmi": "97891943927", "start_time": "2022-03-23T06:00:00Z", "timezone": "America/Los_Angeles", "topic": "My Meeting", "type": 2, "uuid": "aDYlohsHRtCd4ii1uC2+hA==" } ] }



Curl
curl -X GET 'https://api.zoom.us/v2/users/:userId/meetings?type=scheduled&page_size=30&next_page_token=IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2&page_number=1?type=scheduled&page_size=30&next_page_token=IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2&page_number=1' -H 'Accept: application/json'

ENDPOINTS