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 .
Authorization
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.
Settings
In Microsoft 365 reports, user information such as usernames, groups, and sites is concealed; actual values aren't 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 |
|---|---|---|---|
| Admin report settings | ✔ | ➖ | ➖ |
| 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.