Exploring AI Solutions for Enhanced Security

Posted by

Microsoft Support Team provides guidance on how to transition to the reports API for app reporting. Learn how to update your reporting automation and scripts for apps reporting to utilize the reports API to improve accuracy and consistency.

Retrieving Intune Apps Reporting Data from Microsoft Graph Beta API

In March 2023, Microsoft notified customers via MC531735 that they may need to take action to update their reporting automation and scripts for apps reporting to utilize the reports API by mid-May 2023. The documented APIs leverage the newer reporting infrastructure to improve accuracy and consistency in app reporting.

Using the Reports API

The Export Intune reports using Graph APIs documentation explains how to export the reports that have export functionality. The columns (based on the report name) that can be requested in “select” can be found in the Intune reports and properties available using Graph API documentation.

Transitioning to the Reports API for App Reporting

The following table demonstrates how to transition to the reports API for app reporting:

Report NameMobile apps API (old)Export reports for apps API (new)
FailedAppCounts/deviceManagement/mobileApps/getMobileAppCount(status={status})/deviceManagement/reports/getFailedMobileAppsSummaryReport
TopFailedMobileApps/deviceManagement/mobileApps/getTopMobileApps(status={status}, count={count})/deviceManagement/reports/getFailedMobileAppsReport
AppInstallStatusAggregate/deviceManagement/mobileApps/ install summary expanded/deviceManagement/reports/getAppsInstallSummaryReport
AppStatusOverview/deviceManagement/mobileApps({appId})/installSummary/deviceManagement/reports/getAppStatusOverviewReport
DeviceInstallStatusByApp/deviceManagement/mobileApps({appId})/deviceStatuses/deviceManagement/reports/getDeviceInstallStatusReport
UserInstallStatusAggregateByApp/deviceManagement/mobileApps({appId})/userStatuses/deviceManagement/reports/getUserInstallStatusReport
DependentAppsInstallStatus/deviceManagement/mobileApps({appId})/getRelatedAppStates/deviceManagement/reports/getRelatedAppsStatusReport

Note that the following Intune app reports are not available through the export functionality. In these scenarios, you can call the report directly through the Graph API:

  • Number of failed apps
  • Top number of apps with the highest install failures
  • Overview of installation status for one app

Examples of How to Use the Reports APIs

Below are a few examples of how to use the report’s APIs. Please note that applicationId is a required filter for any report based on an application. You can also view these reports in the Microsoft Intune admin center user interface and use a network trace to see what the requests look like.

Example 1: FailedAppCounts report

/deviceManagement/reports/getFailedMobileAppsSummaryReport
Method – POST
Request Body – {filter: “”}
Response – {“TotalRowCount”:1,”Schema”:[{“Column”:”Count”, “PropertyType”:”Int64″}],”Values”:[[1]],”SessionId”:””}

Example 2: TopFailedMobileApps report

/deviceManagement/reports/getFailedMobileAppsReport
Method – POST
Request Body – {top: 3, orderBy: [“FailedDeviceCount desc”]}
Response – {“TotalRowCount”:

Key points from the article:

  • Learn how to transition to the reports API for app reporting
  • Update reporting automation and scripts for apps reporting to utilize the reports API
  • View reports in the Microsoft Intune admin center user interface
  • Use a network trace to see what the requests look like
  • Follow documented instructions to export Intune reports using Graph APIs

From the Intune Customer Success articles


Related Posts
Unlock New Possibilities with Windows Server Devices in Intune!

  Now Recognized as a New OS in Intune Microsoft has announced that Windows Server devices are Read more

Unlock the Power of Microsoft Intune with the 2210 October Edition!

Microsoft Intune is an enterprise mobility management platform that helps organizations manage mobile devices, applications, and data. The October Read more

Unlock the Power of Intune 2.211: What’s New for November!

Microsoft Intune has released its November edition, featuring new updates to help IT admins better manage their organization’s mobile devices. Read more

Unlock the Power of Microsoft Edge on Intune-Managed Shared Android Devices

Microsoft Intune now supports Microsoft on devices, allowing organizations to provide a secure and productive experience for their Read more