Working with Microsoft 365 usage reports in 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.

With Microsoft Graph, you can access Microsoft 365 usage reports resources to get the information about how people in your business are using Microsoft 365 services. For example, you can identify who is using a service a lot and reaching quotas, or who might not need a Microsoft 365 license at all.

For details about the settings that govern identification/de-identification of information in the Microsoft 365 usage reports data, see Microsoft 365 Reports in the admin center .


Microsoft Graph controls access to resources via permissions. You must specify the permissions you need in order to access Reports resources. Typically, you specify permissions in the Microsoft Entra admin center. For more information, see Microsoft Graph permissions reference and Reports permissions.


In Microsoft 365 reports, user information such as usernames, groups, and sites is concealed; actual values are not displayed. You can use the adminReportSettings API to control the display of user information in the reports.

Cloud deployments

The following table shows the availability for each API across all cloud deployments.

APIs Microsoft Graph global service Microsoft Cloud for US Government Microsoft Cloud China operated by 21Vianet Microsoft Cloud for USNat and USSec
Admin Report Settings
Microsoft 365 activations
Microsoft 365 active users
Microsoft 365 Apps usage
Microsoft 365 browser usage
Microsoft 365 groups activity
Microsoft Forms Usage
Microsoft Teams device usage
Microsoft Teams team usage
Microsoft Teams user activity
Outlook activity
Outlook app usage
Outlook mailbox usage
OneDrive activity
OneDrive usage
SharePoint activity
SharePoint site usage
Skype for Business activity
Skype for Business device usage
Skype for Business organizer activity
Skype for Business participant activity
Skype for Business peer-to-peer activity
Yammer activity
Yammer device usage
Yammer groups activity

Next steps

Reports resources and APIs can open up new ways for you to engage with users and manage their experiences with Microsoft Graph. To learn more:

  • Drill down on the methods and properties of the resources most helpful to your scenario.
  • Try the API in the Graph Explorer.