Get upcoming events report

GET {{baseUrl}}/report/upcoming_events?from=<date>&to=<date>&page_size=30&next_page_token=<string>&type=all&group_id=<string>

Use this API to list upcoming meeting and/or webinar events within a specified period of time. The report's time range is limited to one month.

Prerequisites:

  • A Pro or higher plan

Scopes: report:read:admin

Rate Limit Label : Heavy

Request Params

| Key | Datatype | Required | Description | | from | string | | (Required) Start date in 'yyyy-mm-dd' format. The date range defined by the &quot;from&quot; and &quot;to&quot; parameters should only be one month as the report includes only one month worth of data at once. | | to | string | | (Required) End date. | | 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. | | type | string | | The type of event to query.

  • meeting &mdash; A meeting event.
  • webinar &mdash; A webinar event.
  • all &mdash; Both meeting and webinar events.

This value defaults to all. | | group_id | string | | The group ID. To get a group ID, use the List groups API.

Note: The API response will only contain meetings where the host is a member of the queried group ID. |

HEADERS

| Key | Datatype | Required | Description | | Accept | string | | |

RESPONSES

status: OK

{&quot;from&quot;:&quot;\u003cdate\u003e&quot;,&quot;next_page_token&quot;:&quot;\u003cstring\u003e&quot;,&quot;page_size&quot;:30,&quot;to&quot;:&quot;\u003cdate\u003e&quot;,&quot;upcoming_events&quot;:[{&quot;dept&quot;:&quot;\u003cstring\u003e&quot;,&quot;host_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;host_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;start_time&quot;:&quot;\u003cstring\u003e&quot;,&quot;topic&quot;:&quot;\u003cstring\u003e&quot;},{&quot;dept&quot;:&quot;\u003cstring\u003e&quot;,&quot;host_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;host_name&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;start_time&quot;:&quot;\u003cstring\u003e&quot;,&quot;topic&quot;:&quot;\u003cstring\u003e&quot;}]}