title | description | author | ms.localizationpriority | ms.subservice | doc_type |
---|---|---|---|---|---|
List transitiveMemberOf |
Get groups that the organizational contact is a member of. This API request is transitive, and will also return all groups the user is a nested member of. |
dkershaw10 |
medium |
entra-directory-management |
apiPageType |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Get groups that this organizational contact is a member of. The API request is transitive, and returns all groups the organizational contact is a nested member of.
[!INCLUDE national-cloud-support]
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | OrgContact.Read.All and Group.Read.All, Directory.Read.All |
Delegated (personal Microsoft account) | Not supported. |
Application | OrgContact.Read.All and Group.Read.All, Directory.Read.All |
GET /contacts/{id}/transitiveMemberOf
This method supports the OData query parameters to help customize the response, including $select
, $search
, $count
, and $filter
. OData cast is also enabled, for example, you can cast to get just the groups the contact is a member of. You can use $search
on the displayName property. The default and maximum page sizes are 100 and 999 objects respectively.
Header | Value |
---|---|
Authorization | Bearer {token}. Required. Learn more about authentication and authorization. |
Accept | application/json |
Don't supply a request body for this method.
If successful, this method returns a 200 OK
response code and a collection of directoryObject objects in the response body.
The following example shows a request.
GET https://graph.microsoft.com/beta/contacts/e63333f5-3d11-4026-8fe3-c0f7b044dd3a/transitiveMemberOf
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
[!INCLUDE sample-code] [!INCLUDE sdk-documentation]
The following example shows the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"@odata.type": "#microsoft.graph.group",
"id": "id-value",
"createdDateTime": null,
"description": "All users at the company",
"displayName": "All Users",
"groupTypes": [],
"mailEnabled": false,
"securityEnabled": true,
}
]
}