List sessions

GET {{baseUrl}}/videosdk/sessions?type=live&from=2021-10-11&to=2021-10-11&page_size=30&next_page_token=Usse957pzxvmYwlmCZ50a6CNXFrhztxuj82

Use this API to display the total live or past sessions that occurred during a specified period of time. You can specify a monthly date range for this data using the from and to query parameters. The month should fall within the last six months.

The overview response displays whether features such as audio, video, screensharing, and recording were used during the session.

Rate Limit Label : Resource-intensive

Prerequisites:

  • A Video SDK account

Request Params

| Key | Datatype | Required | Description | | type | string | | The type of session to query:

  • past — A past session that occurred during the specified date range.
  • live — A live sessions.

This parameter defaults to live. | | from | string | | (Required) The start date to query, in yyyy-mm-dd format.

The ranges defined in the from and to parameters should only be a one month range. This is because the report only includes one month's worth of data. | | to | string | | (Required) The end date to query, in yyyy-mm-dd format.

The ranges defined in the from and to parameters should only be a one month range. This is because the report only includes one month's worth of data. | | 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. |

HEADERS

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

RESPONSES

status: OK

{"from":"2021-10-11","to":"2021-10-11","page_size":50,"next_page_token":"suQA5LvDBnH5No5OYD7mqpJuFzJqUOHK8U2","sessions":[{"id":"sfk/aOFJSJSYhGwk1hnxgw==","session_name":"My session","start_time":"2021-12-07T05:42:28Z","end_time":"2021-12-07T05:42:28Z","duration":"30:00","user_count":2,"has_voip":true,"has_video":true,"has_screen_share":true,"has_recording":true,"has_pstn":true,"session_key":"my_session_key"},{"id":"sfk/aOFJSJSYhGwk1hnxgw==","session_name":"My session","start_time":"2021-12-07T05:42:28Z","end_time":"2021-12-07T05:42:28Z","duration":"30:00","user_count":2,"has_voip":true,"has_video":true,"has_screen_share":true,"has_recording":true,"has_pstn":true,"session_key":"my_session_key"}]}