Query parameters
-
Status string
Read only the rooms with this status. Can be:
in-progress
(default) orcompleted
Values are
in-progress
,completed
, orfailed
. -
UniqueName string
Read only rooms with the this
unique_name
. -
DateCreatedAfter string(date-time)
Read only rooms that started on or after this date, given as
YYYY-MM-DD
. -
DateCreatedBefore string(date-time)
Read only rooms that started before this date, given as
YYYY-MM-DD
. -
PageSize integer
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
.
GET /v1/Rooms
curl \
-X GET https://video.twilio.com/v1/Rooms \
--user "username:password"
Response examples (200)
{
"meta": {
"first_page_url": "https://example.com",
"key": "string",
"next_page_url": "https://example.com",
"page": 42,
"page_size": 42,
"previous_page_url": "https://example.com",
"url": "https://example.com"
},
"rooms": [
{
"account_sid": "string",
"audio_only": true,
"date_created": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"duration": 42,
"empty_room_timeout": 42,
"enable_turn": true,
"end_time": "2023-05-04T09:42:00+00:00",
"large_room": true,
"links": {},
"max_concurrent_published_tracks": 42,
"max_participant_duration": 42,
"max_participants": 42,
"media_region": "string",
"record_participants_on_connect": true,
"sid": "string",
"status": "in-progress",
"status_callback": "https://example.com",
"status_callback_method": "HEAD",
"type": "go",
"unique_name": "string",
"unused_room_timeout": 42,
"url": "https://example.com",
"video_codecs": [
"VP8"
]
}
]
}
Response examples (200)
{
"meta": {
"first_page_url": "https://example.com",
"key": "string",
"next_page_url": "https://example.com",
"page": 42,
"page_size": 42,
"previous_page_url": "https://example.com",
"url": "https://example.com"
},
"rooms": [
{
"account_sid": "string",
"audio_only": true,
"date_created": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"duration": 42,
"empty_room_timeout": 42,
"enable_turn": true,
"end_time": "2024-05-04T09:42:00+00:00",
"large_room": true,
"links": {},
"max_concurrent_published_tracks": 42,
"max_participant_duration": 42,
"max_participants": 42,
"media_region": "string",
"record_participants_on_connect": true,
"sid": "string",
"status": "in-progress",
"status_callback": "https://example.com",
"status_callback_method": "HEAD",
"type": "go",
"unique_name": "string",
"unused_room_timeout": 42,
"url": "https://example.com",
"video_codecs": [
"VP8"
]
}
]
}