Microsoft Graph reports API overview
The reports API in Microsoft Graph enables you to understand application and resource activity in your Microsoft Entra 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 Microsoft Entra ID.
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 Microsoft Entra 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 a Microsoft Entra tenant
Gain a better understanding of how your users access and use Microsoft Entra 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 |
|---|---|
| Activity | Directory audit Sign-in Provisioning |
| 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 Team activity User activity |
| Microsoft 365 (general) | Activations Active users Apps usage Browser usage (preview) Groups activity |
| OneDrive | Activity Usage |
| Outlook | Activity App usage Mailbox usage |
| Partner billing | Billed usage Unbilled usage |
| SharePoint | Activity Site usage |
| Skype for Business | Activity Device usage Organizer activity Participant activity Peer to peer activity |
| Viva Engage | Activity Device usage Groups activity |
API reference
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
- Partner billing reports API in Microsoft Graph v1.0
- Partner billing reports API in Microsoft Graph beta
Next steps
- Explore the APIs in Graph Explorer.