secureScore resource type

Namespace: microsoft.graph


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a tenant's secure score per day of scoring data, at the tenant and control level. By default, 90 days of data is held. This data is sorted by createdDateTime, from latest to earliest. This will allow you to page responses by using $top=n, where n = the number of days of data that you want to retrieve.


Method Return Type Description
List secureScores secureScores Read properties and metadata of a secureScores object.


Entity type containing properties of the tenant security score (daily snapshot data).

Property Type Description
azureTenantId String GUID string for tenant ID.
createdDateTime DateTimeOffset The date when the entity is created.
id String Combination of azureTenantId_createdDateTime.
licensedUserCount Int32 Licensed user count of the given tenant.
activeUserCount Int32 Active user count of the given tenant.
currentScore Double Tenant current attained score on specified date.
maxScore Double Tenant maximum possible score on specified date.
enabledServices String collection Microsoft-provided services for the tenant (for example, Exchange online, Skype, Sharepoint).
averageComparativeScores averageComparativeScore collection Average score by different scopes (for example, average by industry, average by seating) and control category (Identity, Data, Device, Apps, Infrastructure) within the scope.
controlScores controlScore collection Contains tenant scores for a set of controls.



JSON representation

The following is a JSON representation of the resource.

  "id": "String",
  "azureTenantId": "Guid",
  "createdDate": "DateTimeOffset",
  "licensedUserCount": "Int32",
  "activeUserCount": "Int32",
  "currentScore": "Int32",
  "maxScore": "Int32",
  "averageScore": "Double",
  "enabledServices": "Collection(string)",
  "averageComparativeScores": "Collection(microsoft.graph.SecureScore.averageComparativeScores)",
  "controlScores": "Collection(microsoft.graph.SecureScore.controlScores)",
  "createdDateTime": "2019-02-07T20:33:53.156Z"