title | description | ms.localizationpriority | author | ms.subservice | doc_type |
---|---|---|---|---|---|
List memberOf |
List the groups that this organizational contact is a member of. |
medium |
dkershaw10 |
entra-directory-management |
apiPageType |
Namespace: microsoft.graph
List the groups that this organizational contact is a 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 |
[!INCLUDE limited-info]
GET /contacts/{id}/memberOf
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. |
Don't supply a request body for this method.
If successful, this method returns a 200 OK
response code and collection of directoryObject objects in the response body.
The following example shows a request.
GET https://graph.microsoft.com/v1.0/contacts/e63333f5-3d11-4026-8fe3-c0f7b044dd3a/memberOf
[!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": "024bbfa0-fe5a-4fce-9227-bd6ccf1324bb",
"createdDateTime": "2018-01-18T18:54:43Z",
"description": "Best group ever created",
"displayName": "Best Group",
"groupTypes": [],
"isAssignableToRole": null,
"onPremisesProvisioningErrors": []
}
]
}