List participants
Namespace: microsoft.graph
Retrieve a list of participant objects in the call.
Permissions
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | Not Supported |
Delegated (personal Microsoft account) | Not Supported |
Application | Calls.Initiate.All, Calls.AccessMedia.All |
Note: Permissions are checked when the call is created; no additional permission check is made when calling this API. Calls.AccessMedia.All is only necessary for calls that use app-hosted media.
HTTP request
GET /communications/calls/{id}/participants
Optional query parameters
This method supports the OData query parameters to help customize the response.
Request headers
Name | Description |
---|---|
Authorization | Bearer {token}. Required. |
Request body
Do not supply a request body for this method.
Response
If successful, this method returns a 200 OK
response code and collection of participant objects in the response body.
Example
Request
GET https://graph.microsoft.com/v1.0/communications/calls/7531d31f-d10d-44de-802f-c569dbca451c/participants
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"value":[
{
"@odata.type":"#microsoft.graph.participant",
"info":{
"@odata.type":"#microsoft.graph.participantInfo",
"identity":{
"@odata.type":"#microsoft.graph.identitySet",
"application":{
"@odata.type":"#microsoft.graph.identity",
"id":"f2fa86af-3c51-4bc2-8fc0-475452d9764f",
"displayName":null
},
"user":null,
"device":null,
"phone":null
},
"id":"eec3812a-fdc3-4fb4-825c-a06c9f35414e"
},
"mediaStreams":[
{
"@odata.type":"#microsoft.graph.mediaStream",
"mediaType":"audio",
"sourceId":"3",
"direction":"sendReceive",
"serverMuted":false,
"label":null
}
],
"isMuted":false,
"isInLobby":false,
"id":"a7ebfb2d-871e-419c-87af-27290b22e8db",
"metadata":null
},
{
"@odata.type":"#microsoft.graph.participant",
"info":{
"@odata.type":"#microsoft.graph.participantInfo",
"identity":{
"@odata.type":"#microsoft.graph.identitySet",
"application":{
"@odata.type":"#microsoft.graph.identity",
"displayName":"Test Participant",
"id":"ef43e42b-4c05-4594-9756-1edb3ccbc989"
},
"user":null,
"device":null,
"phone":null
},
"id":"278405a3-f568-4b3e-b684-009193463064"
},
"mediaStreams":[
{
"@odata.type":"#microsoft.graph.mediaStream",
"mediaType":"audio",
"sourceId":"1",
"direction":"sendReceive",
"serverMuted":false,
"label":null
}
],
"isMuted":false,
"isInLobby":false,
"id":"1e126418-44a0-4a94-a6f8-0efe1ad71acb",
"metadata":null
}
],
"@odata.context":"https://graph.microsoft.com/v1.0/$metadata#communications/calls('7531d31f-d10d-44de-802f-c569dbca451c')/participants"
}
Feedback
Submit and view feedback for