Query parameters
-
Type of room. Can be
go
,peer_to_peer
,group
, orgroup_small
.Values are
go
,peer_to_peer
,group
, orgroup_small
. -
Codecs used by participants in the room. Can be
VP8
,H264
, orVP9
.Values are
VP8
,H264
,VP9
, oropus
. -
Room friendly name.
-
Only read rooms that started on or after this ISO 8601 timestamp.
-
Only read rooms that started before this ISO 8601 timestamp.
-
How many resources to return in each list page. The default is 50, and the maximum is 1000.
Minimum value is
1
, maximum value is1000
. -
The page index. This value is simply for client state.
Minimum value is
0
. -
The page token. This is provided by the API.
GET
/v1/Video/Rooms
curl \
--request GET 'https://insights.twilio.com/v1/Video/Rooms' \
--user "username:password"
Response examples (200)
Read empty
{
"meta": {
"key": "rooms",
"url": "https://insights.twilio.com/v1/Video/Rooms?PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://insights.twilio.com/v1/Video/Rooms?PageSize=50&Page=0",
"previous_page_url": null
},
"rooms": []
}
{
"meta": {
"key": "rooms",
"url": "https://insights.twilio.com/v1/Video/Rooms?PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://insights.twilio.com/v1/Video/Rooms?PageSize=50&Page=0",
"previous_page_url": null
},
"rooms": [
{
"url": "https://insights.twilio.com/v1/Video/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"links": {
"participants": "https://insights.twilio.com/v1/Video/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants"
},
"codecs": [
"VP8"
],
"end_time": "2015-07-30T20:00:00Z",
"room_sid": "RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"room_name": "room_name",
"room_type": "go",
"end_reason": "room_ended_via_api",
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"create_time": "2015-07-30T20:00:00Z",
"room_status": "in_progress",
"duration_sec": 50000000,
"media_region": "us1",
"edge_location": "ashburn",
"created_method": "sdk",
"status_callback": "http://www.example.com",
"max_participants": 0,
"processing_state": "complete",
"recording_enabled": false,
"unique_participants": 0,
"status_callback_method": "GET",
"concurrent_participants": 0,
"max_concurrent_participants": 0,
"total_recording_duration_sec": 50000000,
"unique_participant_identities": 0,
"total_participant_duration_sec": 50000000
}
]
}