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
Activity Directory audit
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)
details (preview)
Microsoft Teams Device usage
Team activity (preview)
User activity
Microsoft 365 (general) Activations
Active users
Apps usage
Browser usage (preview)
Groups activity
OneDrive Activity
Outlook Activity
App usage
Mailbox usage
SharePoint Activity
Site usage
Skype for Business Activity
Device usage
Organizer activity
Participant activity
Peer to peer activity
Yammer Activity
Device usage
Groups activity

API reference

Looking for the API reference for this service?

Next steps