Zoom Public API Documentation
List meetings
GET {{baseUrl}}/users/:userId/meetings?type=scheduled&page_size=30&next_page_token=<string>&page_number=<integer>&from=<date>&to=<date>&timezone=<string>
List a meeting host user's scheduled meetings. For user-level apps, pass the 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: Rate Limit Label: me value instead of the userId parameter. meeting:read,meeting:read:adminMEDIUM
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 | Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes. | |
page_number
|
string | The page number of the current page in the returned records. | |
from
|
string | The start date. | |
to
|
string | The end date. | |
timezone
|
string | The timezone to assign to the `from` and `to` value. For a list of supported timezones and their formats, see our [timezone list](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#timezones). |
HEADERS
| Key | Datatype | Required | Description |
Accept
|
string |
RESPONSES
status OK
| {
"next_page_token": "<string>",
"page_count": "<integer>",
"page_number": 1,
"page_size": 30,
"total_records": "<integer>",
"meetings": [
{
"agenda": "<string>",
"created_at": "<dateTime>",
"duration": "<integer>",
"host_id": "<string>",
"id": "<long>",
"join_url": "<string>",
"pmi": "<string>",
"start_time": "<dateTime>",
"timezone": "<string>",
"topic": "<string>",
"type": 8,
"uuid": "<string>"
},
{
"agenda": "<string>",
"created_at": "<dateTime>",
"duration": "<integer>",
"host_id": "<string>",
"id": "<long>",
"join_url": "<string>",
"pmi": "<string>",
"start_time": "<dateTime>",
"timezone": "<string>",
"topic": "<string>",
"type": 8,
"uuid": "<string>"
}
]
} |
Curl
curl -X GET 'https://api.zoom.us/v2/users/:userId/meetings?type=scheduled&page_size=30&next_page_token=<string>&page_number=<integer>&from=<date>&to=<date>&timezone=<string>?type=scheduled&page_size=30&next_page_token=<string>&page_number=<integer>&from=<date>&to=<date>&timezone=<string>' -H 'Accept: application/json'
ENDPOINTS