Query parameters
-
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
,disconnected
, orreconnecting
. -
Read only the Participants with this User
identity
value. -
Read only Participants that started after this date in ISO 8601 format.
-
Read only Participants that started before this date in ISO 8601 format.
-
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/Rooms/{RoomSid}/Participants
curl \
--request GET 'https://video.twilio.com/v1/Rooms/{RoomSid}/Participants' \
--user "username:password"
Response examples (200)
Read empty
{
"meta": {
"key": "participants",
"url": "https://video.twilio.com/v1/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants?PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://video.twilio.com/v1/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants?PageSize=50&Page=0",
"previous_page_url": null
},
"participants": []
}
{
"meta": {
"key": "participants",
"url": "https://video.twilio.com/v1/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants?Status=disconnected&DateCreatedAfter=2017-01-01T00%3A00%3A01Z&DateCreatedBefore=2017-12-31T23%3A59%3A59Z&Identity=alice&PageSize=50&Page=0",
"page": 0,
"page_size": 50,
"next_page_url": null,
"first_page_url": "https://video.twilio.com/v1/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants?Status=disconnected&DateCreatedAfter=2017-01-01T00%3A00%3A01Z&DateCreatedBefore=2017-12-31T23%3A59%3A59Z&Identity=alice&PageSize=50&Page=0",
"previous_page_url": null
},
"participants": [
{
"sid": "PAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"url": "https://video.twilio.com/v1/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants/PAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"links": {
"anonymize": "https://video.twilio.com/v1/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants/PAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Anonymize",
"subscribe_rules": "https://video.twilio.com/v1/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants/PAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/SubscribeRules",
"published_tracks": "https://video.twilio.com/v1/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants/PAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/PublishedTracks",
"subscribed_tracks": "https://video.twilio.com/v1/Rooms/RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/Participants/PAaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/SubscribedTracks"
},
"status": "disconnected",
"duration": 1,
"end_time": "2017-07-30T20:00:01Z",
"identity": "alice",
"room_sid": "RMaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"start_time": "2017-07-30T20:00:00Z",
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"date_created": "2017-07-30T20:00:00Z",
"date_updated": "2017-07-30T20:00:00Z"
}
]
}