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 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,meeting:read:admin
Rate Limit Label: MEDIUM
Request Params
| 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 thefromandtovalue. For a list of supported timezones and their formats, see our timezone list. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"next_page_token":"\u003cstring\u003e","page_count":"\u003cinteger\u003e","page_number":1,"page_size":30,"total_records":"\u003cinteger\u003e","meetings":[{"agenda":"\u003cstring\u003e","created_at":"\u003cdateTime\u003e","duration":"\u003cinteger\u003e","host_id":"\u003cstring\u003e","id":"\u003clong\u003e","join_url":"\u003cstring\u003e","pmi":"\u003cstring\u003e","start_time":"\u003cdateTime\u003e","timezone":"\u003cstring\u003e","topic":"\u003cstring\u003e","type":8,"uuid":"\u003cstring\u003e"},{"agenda":"\u003cstring\u003e","created_at":"\u003cdateTime\u003e","duration":"\u003cinteger\u003e","host_id":"\u003cstring\u003e","id":"\u003clong\u003e","join_url":"\u003cstring\u003e","pmi":"\u003cstring\u003e","start_time":"\u003cdateTime\u003e","timezone":"\u003cstring\u003e","topic":"\u003cstring\u003e","type":8,"uuid":"\u003cstring\u003e"}]}