reportRoot resource type
Namespace: 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.
Represents a container for Microsoft Entra ID and Microsoft 365 reporting resources.
Methods
Microsoft 365 Copilot usage
For details about report views and names, see Microsoft 365 reports - Microsoft 365 Copilot usage.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get the most recent activity data for enabled users of Microsoft 365 Copilot apps. |
| Get user counts summary | Stream | Get the aggregated number of active and enabled users of Microsoft 365 Copilot for a specified time period. |
| Get user counts trend | Stream | Get the trend in the daily number of active and enabled users of Microsoft 365 Copilot for a specified time period. |
Forms activity
For details about report views and names, see Microsoft 365 reports - Forms activity.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get the detailed forms usage per user. |
| Get user counts | Stream | Get the trend in the number of active users for each user type. |
| Get activity counts | Stream | Get the number of activities count by activity type for a specified time period. |
Microsoft Teams device usage
For details about report views and names, see Microsoft 365 reports - Microsoft Teams device usage.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get details about Microsoft Teams device usage by user. |
| Get user counts | Stream | Get the number of daily unique users by device type. |
| Get total user counts | Stream | Get the number of daily unique Microsoft Teams licensed or nonlicensed users by device type. |
| Get distribution user counts | Stream | Get the number of unique users by device type for the selected time period. |
| Get distribution total user counts | Stream | Get the number of unique Microsoft Teams licensed or nonlicensed users by device type for the selected time period. |
Microsoft Teams user activity
For details about report views and names, see Microsoft 365 reports - Microsoft Teams user activity.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get details about Microsoft Teams user activity by user. |
| Get activity counts | Stream | Get the number of Microsoft Teams activities by activity type. The activities are performed by Microsoft Teams licensed users. |
| Get activity total counts | Stream | Get the number of Microsoft Teams activities by activity type. The activities are performed by Microsoft Teams licensed or unlicensed users. |
| Get user counts | Stream | Get the number of users by activity type. The activity types are number of teams chat messages, private chat messages, calls, or meetings. |
| Get total user counts | Stream | Get the number of Microsoft Teams licensed or unlicensed users by activity type. The activity types are number of teams chat messages, private chat messages, calls, or meetings. |
| Get distribution user counts | Stream | Get the number of Microsoft Teams licensed users by activity type for the selected period. The activity types are number of teams chat messages, private chat messages, calls, and meetings. |
| Get distribution total user counts | Stream | Get the number of Microsoft Teams licensed or unlicensed users by activity type for the selected period. The activity types are number of teams chat messages, private chat messages, calls, and meetings. |
| Get total distribution activity counts | Stream | Get the number of Microsoft Teams user activities over the selected period. The activity types are team chat messages, private chat messages, calls, meetings, meetings organized, meetings attended, audio duration, video duration, screen share duration, post messages, and reply messages. |
Microsoft Teams team activity
For details about report views and names, see Microsoft 365 reports - Microsoft Teams usage activity.
| Method | Return type | Description |
|---|---|---|
| Get team detail | Stream | Get details about Teams activity by team. The numbers include activities for both licensed and nonlicensed users. |
| Get team activity counts | Stream | Get the number of team activities across Microsoft Teams. The activity types are related to meetings and messages. |
| Get team activity distribution counts | Stream | Get the number of team activities across Microsoft Teams over a specified time period. |
| Get team counts | Stream | Get the number of teams by type across Microsoft Teams. |
Outlook activity
For details about report views and names, see Microsoft 365 reports - Email Activity.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get details about email activity users have performed. |
| Get activity counts | Stream | Enables you to understand the trends of email activity (like how many were sent, read, and received) in your organization. |
| Get user counts | Stream | Enables you to understand trends on the number of unique users who are performing email activities like send, read, and receive. |
Outlook app usage
Microsoft 365 reports - Email apps usage.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get details about which activities users performed on the various email apps. |
| Get apps user counts | Stream | Get the count of unique users per email app. |
| Get user counts | Stream | Get the count of unique users that connected to Exchange Online using any email app. |
| Get versions user counts | Stream | Get the count of unique users by Outlook desktop version. |
Outlook mailbox usage
For details about report views and names, see Microsoft 365 reports - Mailbox usage.
| Method | Return type | Description |
|---|---|---|
| Get mailbox detail | Stream | Get details about mailbox usage. |
| Get mailbox counts | Stream | Get the total number of user mailboxes in your organization and how many are active each day of the reporting period. A mailbox is considered active if the user sent or read any email. |
| Get quota status mailbox counts | Stream | Get the count of user mailboxes in each quota category. |
| Get storage | Stream | Get the amount of storage used in your organization. |
Microsoft 365 activations
For details about report views and names, see Microsoft 365 reports - Microsoft Office activations.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get details about users who have activated Microsoft 365. |
| Get activation counts | Stream | Get the count of Microsoft 365 activations on desktops and devices. |
| Get user counts | Stream | Get the count of users that are enabled and those that have activated the Office subscription on desktop or devices. |
Microsoft 365 active users
For details about report views and names, see Microsoft 365 reports - Active Users.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get details about Microsoft 365 active users. |
| Get user counts | Stream | Get the count of daily active users in the reporting period by product. |
| Get services user counts | Stream | Get the count of users by activity type and service. |
Microsoft 365 apps usage
For details about report views and names, see Microsoft 365 reports - Microsoft 365 Apps usage.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get details about the usage of Microsoft 365 Apps by user. |
| Get user counts | Stream | Get the number of daily unique users by app. |
| Get platform user counts | Stream | Get the number of daily unique users by platform. |
Microsoft 365 browser usage
For details about report views and names, see Microsoft 365 reports - Microsoft browser usage.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get the detailed browser usage per user. |
| Get user counts | Stream | Get the trend in the number of active users for each browser. |
| Get distribution user counts | Stream | Get the number of users by browser over a specified time period. |
Microsoft 365 groups activity
For details about report views and names, see Microsoft 365 reports - Microsoft 365 groups.
| Method | Return type | Description |
|---|---|---|
| Get group detail | Stream | Get details about Microsoft 365 groups activity by group. |
| Get activity counts | Stream | Get the number of group activities across group workloads. |
| Get group counts | Stream | Get the daily total number of groups and how many of them were active based on email conversations, Viva Engage posts, and SharePoint file activities. |
| Get storage | Stream | Get the total storage used across all group mailboxes and group sites. |
| Get file counts | Stream | Get the total number of files and how many of them were active across all group sites associated with a Microsoft 365 group. |
OneDrive activity
For details about report views and names, see Microsoft 365 reports - OneDrive for Business activity.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get details about OneDrive activity by user. |
| Get user counts | Stream | Get the trend in the number of active OneDrive users. |
| Get file counts | Stream | Get the number of unique, licensed users that performed file interactions against any OneDrive account. |
OneDrive usage
For details about report views and names, see Microsoft 365 reports - OneDrive for Business usage.
| Method | Return type | Description |
|---|---|---|
| Get account detail | Stream | Get details about OneDrive usage by account. |
| Get account counts | Stream | Get the trend in the number of active OneDrive for Business sites. Any site on which users viewed, modified, uploaded, downloaded, shared, or synced files is considered an active site. |
| Get file counts | Stream | Get the total number of files across all sites and how many are active files. A file is considered active if it has been saved, synced, modified, or shared within the specified time period. |
| Get storage | Stream | Get the trend on the amount of storage you are using in OneDrive for Business. |
SharePoint activity
For details about report views and names, see Microsoft 365 reports - SharePoint activity.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get details about SharePoint activity by user. |
| Get file counts | Stream | Get the number of unique, licensed users who interacted with files stored on SharePoint sites. |
| Get user counts | Stream | Get the trend in the number of active users. A user is considered active if he or she has executed a file activity (save, sync, modify, or share) or visited a page within the specified time period. |
| Get pages | Stream | Get the number of unique pages visited by users. |
SharePoint site usage
For details about report views and names, see Microsoft 365 reports - SharePoint site usage.
| Method | Return type | Description |
|---|---|---|
| Get site detail | Stream | Get details about SharePoint site usage. |
| Get file counts | Stream | Get the total number of files across all sites and the number of active files. A file (user or system) is considered active if it has been saved, synced, modified, or shared within the specified time period. |
| Get site counts | Stream | Get the trend of total and active site count during the reporting period. |
| Get storage | Stream | Get the trend of storage allocated and consumed during the reporting period. |
| Get pages | Stream | Get the number of pages viewed across all sites. |
Skype for Business activity
For details about report views and names, see Skype for Business activity.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get details about Skype for Business activity by user. |
| Get activity counts | Stream | Get the trends on how many users organized and participated in conference sessions held in your organization through Skype for Business. The report also includes the number of peer-to-peer sessions. |
| Get user counts | Stream | Get the trends on how many unique users organized and participated in conference sessions held in your organization through Skype for Business. The report also includes the number of peer-to-peer sessions. |
Skype for Business device usage
For details about report views and names, see Skype for Business clients used.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get details about Skype for Business device usage by user. |
| Get distribution user counts | Stream | Get the number of users using unique devices in your organization. The report shows you the number of users per device including Windows, Windows phone, Android phone, iPhone, and iPad. |
| Get user counts | Stream | Get the usage trends on how many users in your organization have connected using the Skype for Business app. You also get a breakdown by the type of device (Windows, Windows phone, Android phone, iPhone, or iPad) on which the Skype for Business client app is installed and used across your organization. |
Skype for Business organizer activity
For details about report views and names, see Skype for Business conference organizer activity.
| Method | Return type | Description |
|---|---|---|
| Get activity counts | Stream | Get usage trends on the number and type of conference sessions held and organized by users in your organization. Types of conference sessions include IM, audio/video, application sharing, web, dial-in/out - third party, and dial-in/out Microsoft. |
| Get user counts | Stream | Get usage trends on the number of unique users and type of conference sessions held and organized by users in your organization. Types of conference sessions include IM, audio/video, application sharing, web, dial-in/out - third party, and dial-in/out Microsoft. |
| Get minute counts | Stream | Get usage trends on the length in minutes and type of conference sessions held and organized by users in your organization. Types of conference sessions include audio/video, and dial-in and dial-out - Microsoft. |
Skype for Business participant activity
For details about report views and names, see Skype for Business conference participant activity.
| Method | Return type | Description |
|---|---|---|
| Get activity counts | Stream | Get usage trends on the number and type of conference sessions that users from your organization participated in. Types of conference sessions include IM, audio/video, application sharing, web, and dial-in/out - third party. |
| Get user counts | Stream | Get usage trends on the number of unique users and type of conference sessions that users from your organization participated in. Types of conference sessions include IM, audio/video, application sharing, web, and dial-in/out - third party. |
| Get minute counts | Stream | Get usage trends on the length in minutes and type of conference sessions that users from your organization participated in. Types of conference sessions include audio/video. |
Skype for Business peer-to-peer activity
For details about report views and names, see Skype for Business peer-to-peer activity.
| Method | Return type | Description |
|---|---|---|
| Get activity counts | Stream | Get usage trends on the number and type of sessions held in your organization. Types of sessions include IM, audio, video, application sharing, and file transfer. |
| Get user counts | Stream | Get usage trends on the number of unique users and type of peer-to-peer sessions held in your organization. Types of sessions include IM, audio, video, application sharing, and file transfers in peer-to-peer sessions. |
| Get minute counts | Stream | Get usage trends on the length in minutes and type of peer-to-peer sessions held in your organization. Types of sessions include audio and video. |
Viva Engage activity
For details about report views and names, see Microsoft 365 reports - Viva Engage Activity.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get details about Viva Engage activity by user. |
| Get activity counts | Stream | Get the trends on the amount of Viva Engage activity in your organization by how many messages were posted, read, and liked. |
| Get user counts | Stream | Get the trends on the number of unique users who posted, read, and liked Viva Engage messages. |
Viva Engage device usage
For details about report views and names, see Microsoft 365 reports - Viva Engage device usage.
| Method | Return type | Description |
|---|---|---|
| Get user detail | Stream | Get details about Viva Engage device usage by user. |
| Get distribution user counts | Stream | Get the number of users by device type. |
| Get user counts | Stream | Get the number of daily users by device type. |
Viva Engage groups activity
For details about report views and names, see Microsoft 365 reports - Viva Engage groups activity.
| Method | Return type | Description |
|---|---|---|
| Get group detail | Stream | Get details about Viva Engage groups activity by group. |
| Get group counts | Stream | Get the total number of groups that existed and how many included group conversation activity. |
| Get activity counts | Stream | Get the number of Viva Engage messages posted, read, and liked in groups. |
Properties
None.
Relationships
| Relationship | Type | Description |
|---|---|---|
| appCredentialSignInActivities | appCredentialSignInActivity collection | Represents a collection of sign-in activities of application credentials. |
| applicationSignInDetailedSummary | applicationSignInDetailedSummary collection | Represents a detailed summary of an application sign-in. |
| authenticationMethods | authenticationMethodsRoot | Container for navigation properties for Microsoft Entra authentication methods resources. |
| credentialUserRegistrationDetails | credentialUserRegistrationDetails collection | Details of the usage of self-service password reset and multifactor authentication (MFA) for all registered users. |
| dailyPrintUsageByPrinter | printUsageByPrinter collection | Retrieve a list of daily print usage summaries, grouped by printer. |
| dailyPrintUsageByUser | printUsageByUser collection | Retrieve a list of daily print usage summaries, grouped by user. |
| healthMonitoring | microsoft.graph.healthMonitoring.healthMonitoringRoot collection | Reports for Microsoft Entra Health Monitoring. |
| monthlyPrintUsageByPrinter | printUsageByPrinter collection | Retrieve a list of monthly print usage summaries, grouped by printer. |
| monthlyPrintUsageByUser | printUsageByUser collection | Retrieve a list of monthly print usage summaries, grouped by user. |
| partners | partners | Represents billing details for a Microsoft direct partner. |
| readingAssignmentSubmission | readingAssignmentSubmission collection | Represents the submission details of the reading assignment associated with this data. |
| reflectCheckInResponse | reflectCheckInResponse collection | Represents the response to the Microsoft Reflect check-in associated with this data. |
| security | securityReportsRoot | Provides the ability to launch a simulated phishing attack that organizations can learn from. |
| servicePrincipalSignInActivities | servicePrincipalSignInActivity collection | Represents a collection of sign-in activities of service principals. |
| serviceActivity | serviceActivity | Reports that relate to tenant-level authentication activities in Microsoft Entra. |
| sla | serviceLevelAgreementRoot | Reports that relate to tenant-level Microsoft Entra Health SLA attainment. |
| userCredentialUsageDetails | userCredentialUsageDetails collection | Represents the self-service password reset (SSPR) usage for a given tenant. |
| userInsights | userInsightsRoot | Represents a collection of user activities on applications in a tenant that is configured for Microsoft Entra External ID for customers. |
JSON representation
The following JSON representation shows the resource type.
{
"@odata.type": "#microsoft.graph.reportRoot"
}