tenantUsage resource type

Namespace: microsoft.graph.managedTenants


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 the number of monthly active users per service in a managed tenant for the previous month. The time period for the data is a sliding window that takes a snapshot once a day.


Method Return type Description
List tenantUsage microsoft.graph.managedTenants.tenantUsage collection Gets the monthly usage data for each service in a managed tenant.


Property Type Description
id String The unique identifier for the tenant. Required. Read-only.
reportDateTime DateTimeOffset The day the report was generated for the previous month. Required. Read-only.
serviceUsages microsoft.graph.managedTenants.serviceUsage collection The number of monthly active users for each service in the tenant. Example services: Excel, Exchange, Intune, Outlook, Teams, Word. Required. Read-only.
tenantId String The Microsoft Entra tenant identifier for the managed tenant. Read-only.
totalActiveUsers Int32 The total number of unique, active users. Required. Read-only.



JSON representation

The following is a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.managedTenants.tenantUsage",
  "id": "String (identifier)",
  "serviceUsages": [
      "@odata.type": "microsoft.graph.managedTenants.serviceUsage"
  "tenantId": "String",
  "reportDateTime": "String (timestamp)",
  "totalActiveUsers": "Integer"