List domainNameReferences

Namespace: microsoft.graph

Retrieve a list of directoryObject with a reference to the domain. The returned list will contain all directory objects that have a dependency on the domain.


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) Domain.Read.All, Domain.ReadWrite.All
Delegated (personal Microsoft account) Not supported.
Application Domain.Read.All, Domain.ReadWrite.All

The work or school account needs to belong to one of the following roles:

  • Global Administrator
  • Domain Name Administrator
  • Partner Tier2 Support
  • Global Reader

When an application queries a relationship that returns a directoryObject type collection, if it does not have permission to read a certain derived type (like device), members of that type are returned but with limited information. With this behaviour applications can request the least privileged permissions they need, rather than rely on the set of Directory.* permissions. For details, see Limited information returned for inaccessible member objects.

HTTP request

GET /domains/{id}/domainNameReferences

Optional query parameters

This method supports the $select and $filter OData Query Parameters to help customize the response. You can only filter by the OData type of the objects returned, for example, /domains/{domainId}/domainNameReferences/ and /domains/{domainId}/domainNameReferences/microsoft.graph.user.

Request headers

Name Description
Authorization 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 collection of directoryObject objects in the response body.



Note: The response object shown here might be shortened for readability.

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

  "@odata.context": "$metadata#directoryObjects",
  "value": [
      "@odata.type": "#microsoft.graph.user",
      "": "",
      "id": "fc9a2c2b-1ddc-486d-a211-5fe8ca77fa1f",
      "accountEnabled": true,
      "city": "Nairobi",
      "createdDateTime": "2021-04-14T05:26:16Z",
      "country": "Kenya",
      "displayName": "Adele Vance",
      "givenName": "Adele",
      "mail": "",
      "mailNickname": "AdeleV"
      "@odata.type": "",
      "": "",
      "id": "eac82bd3-931c-4d47-9e68-735595a8eb8a",
      "createdDateTime": "2021-04-14T06:59:47Z",
      "createdByAppId": "00000005-0000-0ff1-ce00-000000000000",
      "organizationId": "927c6607-8060-4f4a-a5f8-34964ac78d70",
      "description": "Contribute your ideas and ask your questions to our leadership team. And tune in for regular Employee Q & A live events. You can learn more about what",
      "displayName": "CEO Connection",
      "expirationDateTime": "2021-10-11T06:59:47Z",
      "groupTypes": [
      "mail": "",
      "mailEnabled": true,
      "mailNickname": "ceoconnection",
      "resourceBehaviorOptions": [
      "visibility": "Public",
      "writebackConfiguration": {
        "isEnabled": null,
        "onPremisesGroupType": null