Working with Microsoft 365 usage reports in Microsoft Graph

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.

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 365 activations
Microsoft 365 active users
Microsoft 365 apps usage
Microsoft 365 groups activity
Microsoft Teams device usage
Microsoft Teams team activity
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
Viva Engage activity
Viva Engage device usage
Viva Engage 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.