Microsoft Graph reports API overview
The reports API in Microsoft Graph enables you to understand application and resource activity in your Azure Active Directory (Azure AD) tenant.
Why use the reports API?
Integrate Microsoft 365 usage reporting into your organization's existing reporting solution
Many companies have existing reporting solutions that use a reporting application or web portal. You can use the reports API to incorporate Microsoft 365 usage data into your organization's existing reporting solution so that all IT service reports are in a unified location.
Retain usage reports for historical analysis
You can use the reports API to get the data that's available in all usage reports, including organization-level summaries per service, entity-level (user, sites, accounts) usage information for the last 7/30/90/180 days, and daily activity aggregates. This gives you the option to keep historical usage information for as long as required.
Analyze AD FS application activity and configuration
Provides information about a relying party configured with Active Directory Federation Services (AD FS), its aggregated usage, and whether the relying party configuration can be migrated to Azure Active Directory.
Monitor application sign-ins
Monitor the usage of your applications and make decisions about usage patterns.
Determine who is using your applications and how are they using them
The authentication methods usage reports help you understand how users in your organization use Azure Active Directory (Azure AD) capabilities, such as self-service password rest and multi-factor authentication (MFA). These reports help you determine which authentication methods are more successful for your organization, what types of errors end users are running into, and hat campaign you need to run to help your end users adopt the use of self-service password rest and MFA.
Monitor activity on an Azure AD tenant
Gain a better understanding of how your users access and use Azure AD services. You can analyze the data to create custom solutions tailored to your organization's specific needs.
What data can I access by using the reports API?
You can use the reports API to access the data sets listed in the following table.
|Reports API||Data set|
|AD FS applications||Relying part detailed summary (preview)|
|Application registration||Credential user registration count (preview)
Credential user registration details (preview)
User credential usage details (preview)
Credential usage summary (preview)
|Application sign-in||Sign-in summary (preview)
Sign-in details (preview)
|Microsoft Teams||Device usage
|Microsoft 365 (general)||Activations
|Skype for Business||Activity
Peer to peer activity
Looking for the API reference for this service?
- Identity and access reports API in Microsoft Graph beta
- Microsoft 365 usage reports API in Microsoft Graph v1.0
- Microsoft 365 usage reports API in Microsoft Graph beta
- Explore the APIs in Graph Explorer.
Submit and view feedback for