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.
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 thefrom
andto
value. 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"}]}