Get group

Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported.

Get the properties and relationships of a group object.

Default properties

The following represent the default set of properties that are returned when getting or listing groups. These are a subset of all available properties.

  • classification
  • createdDateTime
  • description
  • displayName
  • groupTypes
  • id
  • mail
  • mailEnabled
  • mailNickname
  • membershipRule
  • membershipRuleProcessingState
  • onPremisesLastSyncDateTime
  • onPremisesSecurityIdentifier
  • onPremisesSyncEnabled
  • preferredLanguage
  • proxyAddresses
  • renewedDateTime
  • securityEnabled
  • theme
  • visibility

The following group properties are not returned by default:

  • accessType
  • allowExternalSenders
  • autoSubscribeNewMembers
  • isSubscribedByMail
  • isFavorite
  • unseenCount

To get these properties (except isFavorite), use the $select query parameter. The following are examples:



Since the group resource supports extensions, you can also use the GET operation to get custom properties and extension data in a group instance.


One of the following scopes is required to execute this API: Group.Read.All or Group.ReadWrite.All

HTTP request

GET /groups/{id}

Optional query parameters

This method supports the OData Query Parameters to help customize the response.

Request headers

Name Type Description
Authorization string Bearer {token}. Required.

Request body

Do not supply a request body for this method.


If successful, this method returns a 200 OK response code and group object in the response body.



Here is an example of the request.


Here is an example of the response.

Note: The response object shown here may be truncated for brevity. The default properties will be returned from an actual call, as described above.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: xxx

  "id": "id-value",
  "description": "description-value",
  "displayName": "displayName-value",
  "groupTypes": [
  "mail": "mail-value",
  "mailEnabled": true,
  "mailNickname": "mailNickname-value",
  "onPremisesLastSyncDateTime": "onPremisesLastSyncDateTime-value",
  "onPremisesSecurityIdentifier": "onPremisesSecurityIdentifier-value",
  "onPremisesSyncEnabled": true,
  "proxyAddresses": [
   "securityEnabled": true,
   "visibility": "visibility-value"

See also