Working with Microsoft 365 usage reports in Microsoft Graph

Important

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.

By using Microsoft Graph, you can access Microsoft 365 usage reports resources to get 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 more information 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 through permissions. You must specify the permissions you need 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	Microsoft Cloud for USNat and USSec
Admin report settings	✔	✔	✔	✔
Microsoft 365 Copilot usage	✔	➖	➖	➖
Microsoft 365 activations	✔	✔	✔	➖
Microsoft 365 active users	✔	✔	✔	➖
Microsoft 365 Apps usage	✔	✔	✔	➖
Microsoft 365 browser usage	✔	➖	➖	➖
Microsoft 365 Groups activity	✔	➖	✔	➖
Microsoft Forms usage	✔	➖
Microsoft Graph API usage	✔	➖	➖	➖
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	✔	➖	➖	➖

Programmatically export unlicensed Copilot Chat usage

Currently, no public Microsoft Graph API or PowerShell cmdlet provides access to Copilot Chat usage data for unlicensed users included in the Copilot Chat usage report.

Unlicensed Copilot Chat interactions are logged only in the Microsoft Purview Unified Audit log.

To automatically extract CopilotInteraction events from the unified audit log, use one of the following methods:

• PowerShell: Use Search-UnifiedAuditLog on Exchange Online PowerShell (EXO) to filter CopilotInteraction events and export them to a CSV file. Microsoft Graph PowerShell doesn't expose Search-UnifiedAuditLog and can't query the Unified Audit Log.
• Office 365 management activity API: Stream audit logs into Security Information and Event Management (SIEM) or analytics platforms using this API.

Next steps

Reports resources and APIs can open up new ways for you to engage with users and manage their experiences by using 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.