Room Utilization through API

API and Webhooks
1

We would like to know an API endpoint which will give us the Room Utilization on the basis of provided ZoomRoomId.

I have tried with following endpoint but it don’t output correct data
v2/rooms/{zoomRoomId}/sensor_data?from=2024-10-01T00:00:00Z&to=2024-10-23T00:00:00Z&sensor_type=REAL_TIME_PEOPLE_COUNT

output
{
“from”: “2024-10-01T00:00:00Z”,
“to”: “2024-10-23T00:00:00Z”,
“next_page_token”: “”,
“page_size”: 30,
“total_records”: 0,
“sensor_data”:
}

2

Hi @vidyadhar.sarmalkar
Thanks for reaching out to us and welcome to the Zoom Developer Forum!
Have you tried passing any other sensor_type value?

3

Hello Elisa, no at this moment. We want to pull the usage of meeting room utilization like what we see in dashboard by navigating Zoom Room > Room Details.
May I know an API endpoint for the same?

4

Hi @vidyadhar.sarmalkar
I found the Get Zoom Rooms details endpoint

Can you please take a look at this one to see if it helps you achieve what you are looking for?

5

Hi Elisa, that was my start point but I do not see expected response from the endpoint
First attempt:
Request: v2/rooms/LfFQyfS5R1WBkvPVRmrnxw/sensor_data?from=2024-10-15T00:00:00Z&to=2024-10-31T00:00:00Z
Output:
{
“from”: “2024-10-15T00:00:00Z”,
“to”: “2024-10-31T00:00:00Z”,
“next_page_token”: “”,
“page_size”: 30,
“total_records”: 0,
“sensor_data”:
}

Second attempt
Request: v2/rooms/LfFQyfS5R1WBkvPVRmrnxw/sensor_data?from=2024-10-15T00:00:00Z&to=2024-10-31T00:00:00Z&sensor_type=REAL_TIME_PEOPLE_COUNT
Output:
{
“from”: “2024-10-15T00:00:00Z”,
“to”: “2024-10-31T00:00:00Z”,
“next_page_token”: “”,
“page_size”: 30,
“total_records”: 0,
“sensor_data”:
}

As per the documentation it should be something like below

{
  "from": "2022-06-19T00:00:00Z",
  "to": "2022-06-19T00:00:00Z",
  "next_page_token": "R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42",
  "page_size": 30,
  "total_records": 5,
  "sensor_data": [
    {
      "date_time": "2022-06-19T00:00:00Z",
      "device_id": "NiVvY1NWpE2nulNrhVjgU4jD0swziVrXBbaFZyC3u+o=",
      "sensor_type": "CO2",
      "sensor_value": "102.0"
    }
  ]
}
6

Interesting @vidyadhar.sarmalkar
Could you try passing more recent dates in your from and to parameters? say 11/01 to 11/05 if you have any data available or have you tried querying the entire month? 10/01 to 10/31?

7

Result is same. Please see attached screenshot
Request: v2/rooms/LfFQyfS5R1WBkvPVRmrnxw/sensor_data?from=2024-11-01T00:00:00Z&to=2024-11-05T00:00:00Z&sensor_type=REAL_TIME_PEOPLE_COUNT

Output:
{
“from”: “2024-11-01T00:00:00Z”,
“to”: “2024-11-05T00:00:00Z”,
“next_page_token”: “”,
“page_size”: 30,
“total_records”: 0,
“sensor_data”:
}

8

Thanks for confirming that information @vidyadhar.sarmalkar
I will send you private message to ask for more details, please follow up there