List policies
Namespace: microsoft.graph
Retrieve a list of conditionalAccessPolicy 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) | Policy.Read.All |
Delegated (personal Microsoft account) | Not supported. |
Application | Policy.Read.All |
HTTP request
GET /identity/conditionalAccess/policies
Optional query parameters
This method supports the $skip
, $top
, $count
, $filter
, $orderBy
, and $select
OData query parameters to help customize the response. For general information, see OData query parameters.
Request headers
Name | Description |
---|---|
Authorization | Bearer {token} |
Request body
Do not supply a request body for this method.
Response
If successful, this method returns a 200 OK
response code and a collection of conditionalAccessPolicy objects in the response body.
Example
Request
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/identity/conditionalAccess/policies
Response
The following is an example of the response.
Note: The response object shown here might be shortened for readability.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#conditionalAccess/policies",
"value": [
{
"id": "ad8d2b4a-8d30-413f-88b8-144c6c8d98d9",
"displayName": "SimplePolicy1",
"createdDateTime": null,
"modifiedDateTime": null,
"state": "disabled",
"sessionControls": null,
"conditions": {
"signInRiskLevels": [],
"clientAppTypes": [
"all"
],
"platforms": null,
"locations": null,
"applications": {
"includeApplications": [
"None"
],
"excludeApplications": [],
"includeUserActions": []
},
"users": {
"includeUsers": [
"None"
],
"excludeUsers": [],
"includeGroups": [],
"excludeGroups": [],
"includeRoles": [],
"excludeRoles": []
}
},
"grantControls": {
"operator": "OR",
"builtInControls": [
"block"
],
"customAuthenticationFactors": [],
"termsOfUse": []
}
},
{
"id": "c558e346-969d-40a7-a64e-2df6c2c88490",
"displayName": "SimplePolicy2",
"createdDateTime": null,
"modifiedDateTime": null,
"state": "disabled",
"sessionControls": null,
"conditions": {
"signInRiskLevels": [],
"clientAppTypes": [
"all"
],
"platforms": null,
"locations": null,
"applications": {
"includeApplications": [
"None"
],
"excludeApplications": [],
"includeUserActions": []
},
"users": {
"includeUsers": [
"None"
],
"excludeUsers": [],
"includeGroups": [],
"excludeGroups": [],
"includeRoles": [],
"excludeRoles": []
}
},
"grantControls": {
"operator": "OR",
"builtInControls": [
"mfa"
],
"customAuthenticationFactors": [],
"termsOfUse": []
}
}
]
}
Feedback
Submit and view feedback for