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 Azure Active Directory (Azure AD) portal. 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.
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 app usage||✔||✔||✔||✔|
|Outlook mailbox usage||✔||✔||✔||✔|
|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 device usage||✔||➖||➖||➖|
|Yammer groups activity||✔||➖||➖||➖|
Find out about the latest new features and updates for this API set.
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.