Microsoft Graph reports API overview
Usage reports in the Microsoft 365 admin center enable admins to understand their company's usage across Office 365 services. You can use the reports API in Microsoft Graph to integrate with Office 365 usage reports.
Why use the reports API?
Integrate Office 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 Office 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.
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.
| Office 365 app | Data set | |
|---|---|---|
| Microsoft Teams | Device usage |
User activity |
| Office 365 (general) | Activations Active users Groups activity |
|
| OneDrive | Activity Usage |
|
| Outlook | Activity App usage Mailbox usage |
|
| SharePoint | Activity Site usage |
|
| Skype for Business | Activity Device usage Device usage Participant activity Peer to peer activity |
|
| Yammer | Activity Device usage Groups activity |
API reference
Looking for the API reference for this service?
- Office 365 usage reports API in Microsoft Graph v1.0
- Office 365 usage reports API in Microsoft Graph beta
Next steps
- Explore the APIs in the Graph Explorer.
- Learn more about how to use the reports REST API.