mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-06-23 06:13:41 +00:00
2.3 KiB
2.3 KiB
title, description, keywords, search.product, ms.prod, ms.mktglfcycl, ms.sitesec, ms.pagetype, ms.author, author, ms.localizationpriority, manager, audience, ms.collection, ms.topic
| title | description | keywords | search.product | ms.prod | ms.mktglfcycl | ms.sitesec | ms.pagetype | ms.author | author | ms.localizationpriority | manager | audience | ms.collection | ms.topic |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Get Machine Secure score | Retrieves the organizational machine secure score. | apis, graph api, supported apis, get, alerts, recent | eADQiWindows 10XVcnh | w10 | deploy | library | security | dolmont | DulceMontemayor | medium | dansimp | ITPro | M365-security-compliance | article |
Get Machine Secure score
Applies to: Microsoft Defender Advanced Threat Protection (Microsoft Defender ATP)
- Want to experience Microsoft Defender ATP? Sign up for a free trial.
[!includePrerelease information]
Retrieves the organizational device secure score.
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Use Microsoft Defender ATP APIs for details.
| Permission type | Permission | Permission display name |
|---|---|---|
| Application | Score.Read.Alll | 'Read Threat and Vulnerability Management score' |
| Delegated (work or school account) | Score.Read | 'Read Threat and Vulnerability Management score' |
HTTP request
GET /api/configurationScore
Request headers
| Name | Type | Description |
|---|---|---|
| Authorization | String | Bearer {token}. Required. |
Request body
Empty
Response
If successful, this method returns 200 OK, with the with device secure score data in the response body.
Example
Request
Here is an example of the request.
GET https://api.securitycenter.windows.com/api/configurationScore
Response
Here is an example of the response.
Note
The response list shown here may be truncated for brevity.
{
"@odata.context": "https://api-us.securitycenter.windows.com/api/$metadata#ConfigurationScore/$entity",
"time": "2019-12-03T09:15:58.1665846Z",
"score": 340
}