List domains
Namespace: microsoft.graph
Retrieve a list of domain objects.
Permissions
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) | Directory.Read.All |
| Delegated (personal Microsoft account) | Not supported. |
| Application | Directory.Read.All, Domain.ReadWrite.All |
HTTP request
GET /domains
Optional query parameters
This method supports the OData Query Parameters to help customize the response.
Request headers
| Name | Description |
|---|---|
| Authorization | Bearer {token}. Required. |
| Accept | application/json; |
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 domain objects in the response body.
Example
Request
GET https://graph.microsoft.com/v1.0/domains
Response
Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 245
{
"value": [
{
"authenticationType": "authenticationType-value",
"availabilityStatus": "availabilityStatus-value",
"isAdminManaged": true,
"isDefault": true,
"isInitial": true,
"isRoot": true,
"id": "contoso.com",
"supportedServices": [
"Email",
"OfficeCommunicationsOnline"
]
}
]
}