Path parameters
-
The SID of the room with the Participant resources to read.
Query parameters
-
Status string
Read only the participants with this status. Can be:
connected
ordisconnected
. Forin-progress
Rooms the default Status isconnected
, forcompleted
Rooms onlydisconnected
Participants are returned.Values are
connected
ordisconnected
. -
Identity string
Read only the Participants with this User
identity
value. -
DateCreatedAfter string(date-time)
Read only Participants that started after this date in ISO 8601 format.
-
DateCreatedBefore string(date-time)
Read only Participants that started before this date in ISO 8601 format.
-
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/{RoomSid}/Participants
curl \
-X GET https://video.twilio.com/v1/Rooms/{RoomSid}/Participants \
--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"
},
"participants": [
{
"account_sid": "string",
"date_created": "2023-05-04T09:42:00+00:00",
"date_updated": "2023-05-04T09:42:00+00:00",
"duration": 42,
"end_time": "2023-05-04T09:42:00+00:00",
"identity": "string",
"links": {},
"room_sid": "string",
"sid": "string",
"start_time": "2023-05-04T09:42:00+00:00",
"status": "connected",
"url": "https://example.com"
}
]
}
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"
},
"participants": [
{
"account_sid": "string",
"date_created": "2024-05-04T09:42:00+00:00",
"date_updated": "2024-05-04T09:42:00+00:00",
"duration": 42,
"end_time": "2024-05-04T09:42:00+00:00",
"identity": "string",
"links": {},
"room_sid": "string",
"sid": "string",
"start_time": "2024-05-04T09:42:00+00:00",
"status": "connected",
"url": "https://example.com"
}
]
}