Chilkat Online Tools

VB.NET / Zoom API / List meetings

Back to Collection Items

' This example assumes the Chilkat API to have been previously unlocked.
' See Global Unlock Sample for sample code.

Dim http As New Chilkat.Http
Dim success As Boolean

Dim queryParams As New Chilkat.JsonObject
queryParams.UpdateString("type","live")
queryParams.UpdateString("from","1989-05-07")
queryParams.UpdateString("to","1989-05-07")
queryParams.UpdateInt("page_size",30)
queryParams.UpdateString("next_page_token","quis officia in reprehenderit")
queryParams.UpdateString("include_fields","tracking_fields")

' Adds the "Authorization: Bearer <access_token>" header.
http.AuthToken = "<access_token>"


Dim resp As Chilkat.HttpResponse = http.QuickRequestParams("GET","https://api.zoom.us/v2/metrics/meetings",queryParams)
If (http.LastMethodSuccess = False) Then
    Debug.WriteLine(http.LastErrorText)
    Exit Sub
End If


Dim sbResponseBody As New Chilkat.StringBuilder
resp.GetBodySb(sbResponseBody)

Dim jResp As New Chilkat.JsonObject
jResp.LoadSb(sbResponseBody)
jResp.EmitCompact = False

Debug.WriteLine("Response Body:")
Debug.WriteLine(jResp.Emit())

Dim respStatusCode As Integer = resp.StatusCode
Debug.WriteLine("Response Status Code = " & respStatusCode)
If (respStatusCode >= 400) Then
    Debug.WriteLine("Response Header:")
    Debug.WriteLine(resp.Header)
    Debug.WriteLine("Failed.")

    Exit Sub
End If



' Sample JSON response:
' (Sample code for parsing the JSON response is shown below)

' {
'   "from": "string [date]",
'   "to": "string [date]",
'   "page_count": "integer",
'   "page_size": "integer",
'   "total_records": "integer",
'   "next_page_token": "string",
'   "meetings": [
'     {
'       "uuid": "string [uuid]",
'       "id": "integer",
'       "topic": "string",
'       "host": "string",
'       "email": "string",
'       "user_type": "string",
'       "start_time": "string [date-time]",
'       "end_time": "string [date-time]",
'       "duration": "string",
'       "participants": "integer",
'       "has_pstn": "boolean",
'       "has_voip": "boolean",
'       "has_3rd_party_audio": "boolean",
'       "has_video": "boolean",
'       "has_screen_share": "boolean",
'       "has_recording": "boolean",
'       "has_sip": "boolean",
'       "has_archiving": "boolean"
'     }
'   ]
' }

' Sample code for parsing the JSON response...
' Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code



Dim uuid As String
Dim id As String
Dim topic As String
Dim host As String
Dim email As String
Dim user_type As String
Dim start_time As String
Dim end_time As String
Dim duration As String
Dim participants As String
Dim has_pstn As String
Dim has_voip As String
Dim has_3rd_party_audio As String
Dim has_video As String
Dim has_screen_share As String
Dim has_recording As String
Dim has_sip As String
Dim has_archiving As String

Dim from As String = jResp.StringOf("from")
Dim v_to As String = jResp.StringOf("to")
Dim page_count As String = jResp.StringOf("page_count")
Dim page_size As String = jResp.StringOf("page_size")
Dim total_records As String = jResp.StringOf("total_records")
Dim next_page_token As String = jResp.StringOf("next_page_token")
Dim i As Integer = 0
Dim count_i As Integer = jResp.SizeOfArray("meetings")
While i < count_i
    jResp.I = i
    uuid = jResp.StringOf("meetings[i].uuid")
    id = jResp.StringOf("meetings[i].id")
    topic = jResp.StringOf("meetings[i].topic")
    host = jResp.StringOf("meetings[i].host")
    email = jResp.StringOf("meetings[i].email")
    user_type = jResp.StringOf("meetings[i].user_type")
    start_time = jResp.StringOf("meetings[i].start_time")
    end_time = jResp.StringOf("meetings[i].end_time")
    duration = jResp.StringOf("meetings[i].duration")
    participants = jResp.StringOf("meetings[i].participants")
    has_pstn = jResp.StringOf("meetings[i].has_pstn")
    has_voip = jResp.StringOf("meetings[i].has_voip")
    has_3rd_party_audio = jResp.StringOf("meetings[i].has_3rd_party_audio")
    has_video = jResp.StringOf("meetings[i].has_video")
    has_screen_share = jResp.StringOf("meetings[i].has_screen_share")
    has_recording = jResp.StringOf("meetings[i].has_recording")
    has_sip = jResp.StringOf("meetings[i].has_sip")
    has_archiving = jResp.StringOf("meetings[i].has_archiving")
    i = i + 1
End While

Curl Command

curl -G -d "type=live"
	-d "from=1989-05-07"
	-d "to=1989-05-07"
	-d "page_size=30"
	-d "next_page_token=quis%20officia%20in%20reprehenderit"
	-d "include_fields=tracking_fields"
	-H "Authorization: Bearer <access_token>"
https://api.zoom.us/v2/metrics/meetings

Postman Collection Item JSON

{
  "name": "List meetings",
  "request": {
    "auth": {
      "type": "oauth2"
    },
    "method": "GET",
    "header": [
    ],
    "url": {
      "raw": "{{baseUrl}}/metrics/meetings?type=live&from=1989-05-07&to=1989-05-07&page_size=30&next_page_token=quis officia in reprehenderit&include_fields=tracking_fields",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "metrics",
        "meetings"
      ],
      "query": [
        {
          "key": "type",
          "value": "live",
          "description": "Specify a value to get the response for the corresponding meeting type. The value of this field can be one of the following:<br> <br>`past` - Meeting that already occurred in the specified date range.<br>`pastOne` - Past meetings that were attended by only one user. <br>`live` - Live meetings.<br><br>\n\nIf you do not provide this field, the default value will be `live` and thus, the API will only query responses for live meetings."
        },
        {
          "key": "from",
          "value": "1989-05-07",
          "description": "(Required) Start date in 'yyyy-mm-dd' format. The date range defined by the \"from\" and \"to\" parameters should only be one month as the report includes only one month worth of data at once."
        },
        {
          "key": "to",
          "value": "1989-05-07",
          "description": "(Required) End date."
        },
        {
          "key": "page_size",
          "value": "30",
          "description": "The number of records returned within a single API call."
        },
        {
          "key": "next_page_token",
          "value": "quis officia in reprehenderit",
          "description": "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."
        },
        {
          "key": "include_fields",
          "value": "tracking_fields",
          "description": "Set the value of this field to \"tracking_fields\" if you would like to include tracking fields of each meeting in the response."
        }
      ]
    },
    "description": "List total live or past meetings that occurred during a specified period of time. This overview will show if features such as audio, video, screen sharing, and recording were being used in the meeting. You can also see the license types of each user on your account.<br> You can specify a monthly date range for the dashboard data using the `from` and `to` query parameters. The month should fall within the last six months.<br>\n**Scopes:** `dashboard_meetings:read:admin`<br>\n **[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Resource-intensive`<br><br>\n**Prerequisites:** <br>\n* Business or a higher plan.<br><br>"
  },
  "response": [
    {
      "name": "**HTTP Status Code:** `200`<br>\nMeetings returned.<br>\nOnly available for paid accounts that have dashboard feature enabled.",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "description": "Added as a part of security scheme: oauth2",
            "key": "Authorization",
            "value": "<token>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/metrics/meetings?type=live&from=1989-05-07&to=1989-05-07&page_size=30&next_page_token=quis officia in reprehenderit&include_fields=tracking_fields",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "metrics",
            "meetings"
          ],
          "query": [
            {
              "key": "type",
              "value": "live"
            },
            {
              "key": "from",
              "value": "1989-05-07"
            },
            {
              "key": "to",
              "value": "1989-05-07"
            },
            {
              "key": "page_size",
              "value": "30"
            },
            {
              "key": "next_page_token",
              "value": "quis officia in reprehenderit"
            },
            {
              "key": "include_fields",
              "value": "tracking_fields"
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"from\": \"string [date]\",\n \"to\": \"string [date]\",\n \"page_count\": \"integer\",\n \"page_size\": \"integer\",\n \"total_records\": \"integer\",\n \"next_page_token\": \"string\",\n \"meetings\": [\n  {\n   \"uuid\": \"string [uuid]\",\n   \"id\": \"integer\",\n   \"topic\": \"string\",\n   \"host\": \"string\",\n   \"email\": \"string\",\n   \"user_type\": \"string\",\n   \"start_time\": \"string [date-time]\",\n   \"end_time\": \"string [date-time]\",\n   \"duration\": \"string\",\n   \"participants\": \"integer\",\n   \"has_pstn\": \"boolean\",\n   \"has_voip\": \"boolean\",\n   \"has_3rd_party_audio\": \"boolean\",\n   \"has_video\": \"boolean\",\n   \"has_screen_share\": \"boolean\",\n   \"has_recording\": \"boolean\",\n   \"has_sip\": \"boolean\",\n   \"has_archiving\": \"boolean\"\n  }\n ]\n}"
    },
    {
      "name": "**Error Code:** `300`<br>\nThe next page token is invalid or expired.",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "description": "Added as a part of security scheme: oauth2",
            "key": "Authorization",
            "value": "<token>"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/metrics/meetings?type=live&from=1989-05-07&to=1989-05-07&page_size=30&next_page_token=quis officia in reprehenderit&include_fields=tracking_fields",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "metrics",
            "meetings"
          ],
          "query": [
            {
              "key": "type",
              "value": "live"
            },
            {
              "key": "from",
              "value": "1989-05-07"
            },
            {
              "key": "to",
              "value": "1989-05-07"
            },
            {
              "key": "page_size",
              "value": "30"
            },
            {
              "key": "next_page_token",
              "value": "quis officia in reprehenderit"
            },
            {
              "key": "include_fields",
              "value": "tracking_fields"
            }
          ]
        }
      },
      "status": "Multiple Choices",
      "code": 300,
      "_postman_previewlanguage": "text",
      "header": [
        {
          "key": "Content-Type",
          "value": "text/plain"
        }
      ],
      "cookie": [
      ],
      "body": ""
    }
  ]
}