Microsoft

Microsoft Graph: Audit logs and usage reports

Read sign-in logs, directory audit logs and provisioning logs, and Microsoft 365 usage and activity reports. This listing is one area of Microsoft Graph, the…

Data & analytics#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Read sign-in logs, directory audit logs and provisioning logs, and Microsoft 365 usage and activity reports.

This listing is one area of Microsoft Graph, the single REST API for Microsoft 365, Outlook, OneDrive, Teams and Microsoft Entra ID. It holds 207 of the area's requests, the most direct ones first, generated from Microsoft's own OpenAPI description of Graph v1.0. The other areas (mail, calendar, files, Teams, users and more) are listed separately on the Microsoft page.

Get an access token

  1. Sign in to the Microsoft Entra admin center and open App registrations > New registration. For a quick test, the Graph Explorer signs you in and shows a token without registering anything.
  2. Under API permissions, add the Microsoft Graph permissions this area needs, for example: AuditLog.Read.All, Reports.Read.All. Delegated permissions act as the signed-in user; application permissions act as the app itself and need an administrator's consent.
  3. Under Certificates & secrets, create a client secret (keep it out of shared collections).
  4. Get a token from https://login.microsoftonline.com/ /oauth2/v2.0/token: the authorization-code flow for a user, or grant_type=client_credentials with scope=https://graph.microsoft.com/.default for an app. Send it as Authorization: Bearer .

Using these requests

  • Base URL: https://graph.microsoft.com/v1.0. /me/... paths act on the signed-in user; with an application token use /users/{id or userPrincipalName}/... instead.
  • Shape responses with OData query parameters: $select (fields), $filter, $orderby, $top, $expand and $search (some need the ConsistencyLevel: eventual header). Long lists are paged: follow @odata.nextLink.
  • Combine up to 20 requests in one call with POST /$batch.

Common errors

StatusCodeWhat to do
401InvalidAuthenticationTokenThe token is missing, expired or for another resource: get a new one for https://graph.microsoft.com.
403Authorization_RequestDenied / ErrorAccessDeniedAdd the permission listed in the request's docs and grant consent.
404ResourceNotFound / itemNotFoundCheck the id; ids from another user or tenant are not found.
429TooManyRequestsThrottled: wait the Retry-After seconds, then retry.

Docs: Audit logs and usage reports overview · Permissions reference · Throttling

Endpoints 207

Reports

  • GETList reports/reports
  • PATCHUpdate reports/reports
  • GETGet office365 activation counts (report)/reports/getOffice365ActivationCounts()Get the count of Microsoft 365 activations on desktops and devices.
  • GETDevice configuration user activity (report)/reports/deviceConfigurationUserActivity()Metadata for the device configuration user activity report
  • GETDevice configuration device activity (report)/reports/deviceConfigurationDeviceActivity()Metadata for the device configuration device activity report
  • GETGet office365 activations user counts (report)/reports/getOffice365ActivationsUserCounts()Get the count of users that are enabled and the ones that activated the Office subscription on desktop or devices or shared computers.
  • GETGet office365 activations user detail (report)/reports/getOffice365ActivationsUserDetail()Get details about users who have activated Microsoft 365.
  • GETManaged device enrollment top failures (report)/reports/managedDeviceEnrollmentTopFailures()
  • GETManaged device enrollment failure details (report)/reports/managedDeviceEnrollmentFailureDetails()
  • GETGet m365 app user detail (report)/reports/getM365AppUserDetail(date=:date)Get a report that provides the details about which apps and platforms users have used.
  • GETGet report/reports/getTeamsTeamCounts(period=':period')Get the number of teams of a particular type in an instance of Microsoft Teams.
  • GETGet email activity user detail (report)/reports/getEmailActivityUserDetail(date=:date)Get details about email activity users have performed.
  • GETGet email app usage user detail (report)/reports/getEmailAppUsageUserDetail(date=:date)Get details about which activities users performed on the various email apps.
  • GETGet report/reports/getM365AppUserCounts(period=':period')Get a report that provides the trend in the number of active users for each app (Outlook, Word, Excel, PowerPoint, OneNote, and Teams) in your organization.
  • GETGet report/reports/getM365AppUserDetail(period=':period')Get a report that provides the details about which apps and platforms users have used.
  • GETGet teams team activity detail (report)/reports/getTeamsTeamActivityDetail(date=:date)Get details about Microsoft Teams activity by team. The numbers include activities for both licensed and nonlicensed users.
  • GETGet report/reports/getMailboxUsageDetail(period=':period')Get details about mailbox usage.
  • GETGet yammer activity user detail (report)/reports/getYammerActivityUserDetail(date=:date)Get details about Yammer activity by user.
  • GETGet report/reports/getEmailActivityCounts(period=':period')Enables you to understand the trends of email activity (like how many were sent, read, and received) in your organization.
  • GETGet report/reports/getMailboxUsageStorage(period=':period')Get the amount of storage used in your organization.
  • GETGet office365 active user detail (report)/reports/getOffice365ActiveUserDetail(date=:date)Get details about Microsoft 365 active users.
  • GETGet share point site usage detail (report)/reports/getSharePointSiteUsageDetail(date=:date)Get details about SharePoint site usage.
  • GETGet one drive activity user detail (report)/reports/getOneDriveActivityUserDetail(date=:date)Get details about OneDrive activity by user.
  • GETGet one drive usage account detail (report)/reports/getOneDriveUsageAccountDetail(date=:date)Get details about OneDrive usage by account.
  • GETGet report/reports/getOneDriveUsageStorage(period=':period')Get the trend on the amount of storage you're using in OneDrive for Business.
  • GETGet teams device usage user detail (report)/reports/getTeamsDeviceUsageUserDetail(date=:date)Get details about Microsoft Teams device usage by user.
  • GETGet report/reports/getYammerActivityCounts(period=':period')Get the trends on the amount of Yammer activity in your organization by how many messages were posted, read, and liked.
  • GETGet yammer groups activity detail (report)/reports/getYammerGroupsActivityDetail(date=:date)Get details about Yammer groups activity by group.
  • GETGet teams user activity user detail (report)/reports/getTeamsUserActivityUserDetail(date=:date)Get details about Microsoft Teams user activity by user.
  • GETGet yammer device usage user detail (report)/reports/getYammerDeviceUsageUserDetail(date=:date)Get details about Yammer device usage by user.
  • GETGet share point activity user detail (report)/reports/getSharePointActivityUserDetail(date=:date)Get details about SharePoint activity by user.
  • GETGet report/reports/getEmailActivityUserCounts(period=':period')Enables you to understand trends on the number of unique users who are performing email activities like send, read, and receive.
  • GETGet report/reports/getEmailActivityUserDetail(period=':period')Get details about email activity users have performed.
  • GETGet report/reports/getEmailAppUsageUserCounts(period=':period')Get the count of unique users that connected to Exchange Online using any email app.
  • GETGet report/reports/getEmailAppUsageUserDetail(period=':period')Get details about which activities users performed on the various email apps.
  • GETGet office365 groups activity detail (report)/reports/getOffice365GroupsActivityDetail(date=:date)Get details about Microsoft 365 groups activity by group.
  • GETGet report/reports/getOneDriveUsageFileCounts(period=':period')Get the total number of files across all sites and how many are active files. A file is considered active if it has been saved, synced, modified, or shared…
  • GETGet report/reports/getSharePointActivityPages(period=':period')Get the number of unique pages visited by users.
  • GETGet report/reports/getTeamsTeamActivityCounts(period=':period')Get the number of team activities across Microsoft Teams. The activity types are related to meetings and messages.
  • GETGet report/reports/getTeamsTeamActivityDetail(period=':period')Get details about Microsoft Teams activity by team. The numbers include activities for both licensed and nonlicensed users.
  • GETGet report/reports/getTeamsUserActivityCounts(period=':period')Get the number of Microsoft Teams activities by activity type. The activities are performed by Microsoft Teams licensed users.
  • GETGet report/reports/getSharePointSiteUsagePages(period=':period')Get the number of pages viewed across all sites.
  • GETGet report/reports/getYammerActivityUserCounts(period=':period')Get the trends on the number of unique users who posted, read, and liked Yammer messages.
  • GETGet report/reports/getYammerActivityUserDetail(period=':period')
  • GETGet report/reports/getM365AppPlatformUserCounts(period=':period')Get a report that provides the trend of active users across all apps for each platform (Windows, Mac, web, and mobile) in your organization.
  • GETGet report/reports/getMailboxUsageMailboxCounts(period=':period')Get the total number of user mailboxes in your organization and how many are active each day of the reporting period. A mailbox is considered active if the…
  • GETGet report/reports/getOffice365ActiveUserCounts(period=':period')Get the count of daily active users in the reporting period by product.
  • GETGet report/reports/getOffice365ActiveUserDetail(period=':period')
  • GETGet report/reports/getSharePointSiteUsageDetail(period=':period')
  • GETGet report/reports/getOneDriveActivityFileCounts(period=':period')Get the number of unique, licensed users that performed file interactions against any OneDrive account.
  • GETGet report/reports/getOneDriveActivityUserCounts(period=':period')Get the trend in the number of active OneDrive users.
  • GETGet report/reports/getOneDriveActivityUserDetail(period=':period')
  • GETGet report/reports/getOneDriveUsageAccountCounts(period=':period')Get the trend in the number of active OneDrive for Business sites. Any site on which users viewed, modified, uploaded, downloaded, shared, or synced files is…
  • GETGet report/reports/getOneDriveUsageAccountDetail(period=':period')
  • GETGet report/reports/getSharePointSiteUsageStorage(period=':period')Get the trend of storage allocated and consumed during the reporting period.
  • GETGet report/reports/getTeamsDeviceUsageUserCounts(period=':period')Get the number of Microsoft Teams daily unique users by device type.
  • GETGet report/reports/getTeamsDeviceUsageUserDetail(period=':period')Get details about Microsoft Teams device usage by user.
  • GETGet report/reports/getYammerGroupsActivityCounts(period=':period')Get the number of Yammer messages posted, read, and liked in groups.
  • GETGet report/reports/getYammerGroupsActivityDetail(period=':period')
  • GETGet report/reports/getEmailAppUsageAppsUserCounts(period=':period')Get the count of unique users per email app.
  • GETGet report/reports/getOffice365ServicesUserCounts(period=':period')Get the count of users by activity type and service.
  • GETGet report/reports/getRelyingPartyDetailedSummary(period=':period')Get a summary of AD FS relying parties information.
  • GETGet report/reports/getTeamsUserActivityUserCounts(period=':period')Get the number of Microsoft Teams users by activity type. The activity types are number of teams chat messages, private chat messages, calls, or meetings.
  • GETGet report/reports/getTeamsUserActivityUserDetail(period=':period')Get details about Microsoft Teams user activity by user.
  • GETGet report/reports/getYammerDeviceUsageUserCounts(period=':period')Get the number of daily users by device type.
  • GETGet report/reports/getYammerDeviceUsageUserDetail(period=':period')
  • GETGet report/reports/getSharePointActivityFileCounts(period=':period')Get the number of unique, licensed users who interacted with files stored on SharePoint sites.
  • GETGet report/reports/getSharePointActivityUserCounts(period=':period')Get the trend in the number of active users. A user is considered active if they have executed a file activity (save, sync, modify, or share) or visited a…
  • GETGet report/reports/getSharePointActivityUserDetail(period=':period')
  • GETGet skype for business activity user detail (report)/reports/getSkypeForBusinessActivityUserDetail(date=:date)Get details about Skype for Business activity by user.
  • GETGet report/reports/getOffice365GroupsActivityCounts(period=':period')Get the number of group activities across group workloads.
  • GETGet report/reports/getOffice365GroupsActivityDetail(period=':period')
  • GETGet report/reports/getSharePointSiteUsageFileCounts(period=':period')Get the total number of files across all sites and the number of active files. A file (user or system) is considered active if it has been saved, synced,…
  • GETGet report/reports/getSharePointSiteUsageSiteCounts(period=':period')Get the trend of total and active site count during the reporting period.
  • GETGet report/reports/getOffice365GroupsActivityStorage(period=':period')Get the total storage used across all group mailboxes and group sites.
  • GETGet report/reports/getSkypeForBusinessActivityCounts(period=':period')Get the trends on how many users organized and participated in conference sessions held in your organization through Skype for Business. The report also…
  • GETGet report/reports/getEmailAppUsageVersionsUserCounts(period=':period')Get the count of unique users by Outlook desktop version.
  • GETGet skype for business device usage user detail (report)/reports/getSkypeForBusinessDeviceUsageUserDetail(date=:date)Get details about Skype for Business device usage by user.
  • GETGet report/reports/getYammerGroupsActivityGroupCounts(period=':period')Get the total number of groups that existed and how many included group conversation activities.
  • GETGet report/reports/managedDeviceEnrollmentTopFailures(period=':period')
  • GETGet report/reports/getOffice365GroupsActivityFileCounts(period=':period')Get the total number of files and how many of them were active across all group sites associated with a Microsoft 365 group.
  • GETGet report/reports/getOffice365GroupsActivityGroupCounts(period=':period')Get the daily total number of groups and how many of them were active based on email conversations, Yammer posts, and SharePoint file activities.
  • GETGet report/reports/getSkypeForBusinessActivityUserCounts(period=':period')Get the trends on how many unique users organized and participated in conference sessions held in your organization through Skype for Business. The report…
  • GETGet report/reports/getSkypeForBusinessActivityUserDetail(period=':period')
  • GETGet report/reports/getTeamsTeamActivityDistributionCounts(period=':period')Get the number of team activities across Microsoft Teams over a selected period.
  • GETGet report/reports/getMailboxUsageQuotaStatusMailboxCounts(period=':period')Get the count of user mailboxes in each quota category.
  • GETGet report/reports/getSkypeForBusinessDeviceUsageUserCounts(period=':period')Get the usage trends on how many users in your organization have connected using the Skype for Business app. You'll also get a breakdown by the type of device…
  • GETGet report/reports/getSkypeForBusinessDeviceUsageUserDetail(period=':period')
  • GETGet report/reports/getTeamsDeviceUsageDistributionUserCounts(period=':period')Get the number of Microsoft Teams unique users by device type over the selected time period.
  • GETGet report/reports/getSkypeForBusinessOrganizerActivityCounts(period=':period')Get usage trends on the number and type of conference sessions held and organized by users in your organization. Types of conference sessions include IM,…
  • GETGet report/reports/getYammerDeviceUsageDistributionUserCounts(period=':period')Get the number of users by device type.
  • GETGet report/reports/getSkypeForBusinessPeerToPeerActivityCounts(period=':period')Get usage trends on the number and type of sessions held in your organization. Types of sessions include IM, audio, video, application sharing, and file…
  • GETGet report/reports/getSkypeForBusinessParticipantActivityCounts(period=':period')Get usage trends on the number and type of conference sessions that users from your organization participated in. Types of conference sessions include IM,…
  • GETGet report/reports/getSkypeForBusinessOrganizerActivityUserCounts(period=':period')Get usage trends on the number of unique users and type of conference sessions held and organized by users in your organization. Types of conference sessions…
  • GETGet report/reports/getSkypeForBusinessPeerToPeerActivityUserCounts(period=':period')Get usage trends on the number of unique users and type of peer-to-peer sessions held in your organization. Types of sessions include IM, audio, video,…
  • GETGet report/reports/getSkypeForBusinessOrganizerActivityMinuteCounts(period=':period')Get usage trends on the length in minutes and type of conference sessions held and organized by users in your organization. Types of conference sessions…
  • GETGet report/reports/getSkypeForBusinessParticipantActivityUserCounts(period=':period')Get usage trends on the number of unique users and type of conference sessions that users from your organization participated in. Types of conference sessions…
  • GETGet report/reports/getSkypeForBusinessPeerToPeerActivityMinuteCounts(period=':period')Get usage trends on the length in minutes and type of peer-to-peer sessions held in your organization. Types of sessions include audio and video.
  • GETGet report/reports/getSkypeForBusinessParticipantActivityMinuteCounts(period=':period')Get usage trends on the length in minutes and type of conference sessions that users from your organization participated in. Types of conference sessions…
  • GETGet report/reports/getSkypeForBusinessDeviceUsageDistributionUserCounts(period=':period')Get the number of users using unique devices in your organization. The report will show you the number of users per device including Windows, Windows phone,…
  • GETGet report/reports/getUserArchivedPrintJobs(userId=':userId',startDateTime=:startDateTime,endDateTime=:endDateTime)Get a list of archived print jobs for a particular user.
  • GETGet report/reports/getGroupArchivedPrintJobs(groupId=':groupId',startDateTime=:startDateTime,endDateTime=:endDateTime)Get a list of archived print jobs for a particular group.
  • GETGet report/reports/managedDeviceEnrollmentFailureDetails(skip=:skip,top=:top,filter=':filter',skipToken=':skipToken')
  • GETGet report/reports/getPrinterArchivedPrintJobs(printerId=':printerId',startDateTime=:startDateTime,endDateTime=:endDateTime)Get a list of archived print jobs that were queued for particular printer.

Audit logs

  • GETList audit logs/auditLogs
  • PATCHUpdate audit logs/auditLogs

Reports: partners

  • GETList partners/reports/partnersRepresents billing details for a Microsoft direct partner.
  • DELETEDelete partners/reports/partners
  • PATCHUpdate partners/reports/partners
  • GETGet billing/reports/partners/billingRepresents billing details for billed and unbilled data.
  • DELETEDelete billing/reports/partners/billing
  • PATCHUpdate billing/reports/partners/billing
  • GETGet usage/reports/partners/billing/usageRepresents details for billed and unbilled Azure usage data.
  • DELETEDelete usage/reports/partners/billing/usage
  • PATCHUpdate usage/reports/partners/billing/usage
  • GETList manifests/reports/partners/billing/manifestsRead the properties and relationships of a manifest object.
  • POSTCreate manifest/reports/partners/billing/manifests
  • GETList operations/reports/partners/billing/operationsRead the properties and relationships of an operation object.
  • POSTCreate operation/reports/partners/billing/operations
  • GETGet reconciliation/reports/partners/billing/reconciliationRepresents details for billed and unbilled invoice reconciliation data.
  • DELETEDelete reconciliation/reports/partners/billing/reconciliation
  • PATCHUpdate reconciliation/reports/partners/billing/reconciliation
  • GETGet aggregated usage/reports/partners/billing/aggregatedUsageRepresents aggregated Azure usage data for partner billing.
  • DELETEDelete aggregated usage/reports/partners/billing/aggregatedUsage
  • PATCHUpdate aggregated usage/reports/partners/billing/aggregatedUsage
  • GETGet billed/reports/partners/billing/usage/billedRepresents details for billed Azure usage data.
  • DELETEDelete billed/reports/partners/billing/usage/billed
  • PATCHUpdate billed/reports/partners/billing/usage/billed
  • GETGet unbilled/reports/partners/billing/usage/unbilledRepresents details for unbilled Azure usage data.
  • DELETEDelete unbilled/reports/partners/billing/usage/unbilled
  • PATCHUpdate unbilled/reports/partners/billing/usage/unbilled
  • GETGet billed/reports/partners/billing/reconciliation/billedRepresents details for billed invoice reconciliation data.
  • DELETEDelete billed/reports/partners/billing/reconciliation/billed
  • PATCHUpdate billed/reports/partners/billing/reconciliation/billed
  • GETGet billed/reports/partners/billing/aggregatedUsage/billedThe billed aggregated usage data that can be exported.
  • DELETEDelete billed/reports/partners/billing/aggregatedUsage/billed
  • PATCHUpdate billed/reports/partners/billing/aggregatedUsage/billed
  • GETGet unbilled/reports/partners/billing/reconciliation/unbilledRepresents details for unbilled invoice reconciliation data.
  • DELETEDelete unbilled/reports/partners/billing/reconciliation/unbilled
  • PATCHUpdate unbilled/reports/partners/billing/reconciliation/unbilled
  • GETGet manifest/reports/partners/billing/manifests/:manifest-idRead the properties and relationships of a manifest object.
  • DELETEDelete manifest/reports/partners/billing/manifests/:manifest-id
  • PATCHUpdate manifest/reports/partners/billing/manifests/:manifest-id
  • GETGet operation/reports/partners/billing/operations/:operation-idRead the properties and relationships of an operation object.
  • DELETEDelete operation/reports/partners/billing/operations/:operation-id
  • PATCHUpdate operation/reports/partners/billing/operations/:operation-id
  • POSTCreate partners.billing.export/reports/partners/billing/usage/billed/microsoft.graph.partners.billing.exportExport the billed Azure usage data.
  • POSTCreate partners.billing.export/reports/partners/billing/usage/unbilled/microsoft.graph.partners.billing.exportExport unbilled Azure usage data for a specific billing period and currency.
  • POSTCreate partners.billing.export/reports/partners/billing/reconciliation/billed/microsoft.graph.partners.billing.exportExport the billed invoice reconciliation data.
  • POSTCreate partners.billing.export/reports/partners/billing/aggregatedUsage/billed/microsoft.graph.partners.billing.exportExport billed aggregated Azure usage data for a specific invoice from a billedAggregatedUsage resource.
  • POSTCreate partners.billing.export/reports/partners/billing/reconciliation/unbilled/microsoft.graph.partners.billing.exportExport the unbilled invoice reconciliation data for a specific billing period and a given currency.

Reports: security

  • GETGet security/reports/securityRepresents an abstract type that contains resources for attack simulation and training reports.
  • DELETEDelete security/reports/security
  • PATCHUpdate security/reports/security
  • GETGet attack simulation repeat offenders (security)/reports/security/getAttackSimulationRepeatOffenders()List the tenant users who have yielded to attacks more than once in attack simulation and training campaigns. This function supports @odata.nextLink for…
  • GETGet attack simulation training user coverage (security)/reports/security/getAttackSimulationTrainingUserCoverage()List training coverage for tenant users in attack simulation and training campaigns. This function supports @odata.nextLink for pagination.
  • GETGet attack simulation simulation user coverage (security)/reports/security/getAttackSimulationSimulationUserCoverage()List training coverage for each tenant user in attack simulation and training campaigns. This function supports @odata.nextLink for pagination.

Audit logs: sign ins

  • GETList sign ins/auditLogs/signInsRetrieve the Microsoft Entra user sign-ins for your tenant. Sign-ins that are interactive in nature (where a username/password is passed as part of auth…
  • POSTCreate sign in/auditLogs/signIns
  • POSTDismiss sign in/auditLogs/signIns/dismissMark an event in Microsoft Entra sign-in logs as dismissed. For details about investigating Identity Protection risks, see How to investigate risk.
  • POSTCreate confirm safe/auditLogs/signIns/confirmSafeMark an event in Microsoft Entra sign-in logs as safe. Admins can either mark the events flagged as risky by Microsoft Entra ID Protection as safe, or they…
  • POSTCreate confirm compromised/auditLogs/signIns/confirmCompromisedMark an event in the Microsoft Entra sign-in logs as risky. Events marked as risky by an admin are immediately flagged as high risk in Microsoft Entra ID…
  • GETGet sign in/auditLogs/signIns/:signIn-idRetrieve a specific Microsoft Entra user sign-in event for your tenant. Sign-ins that are interactive in nature (where a username/password is passed as part…
  • DELETEDelete sign in/auditLogs/signIns/:signIn-id
  • PATCHUpdate sign in/auditLogs/signIns/:signIn-id

Audit logs: provisioning

  • GETGet provisioning/auditLogs/provisioningGet all provisioningObjectSummary events that occurred in your tenant, such as the deletion of a group in a target application or the creation of a user when…
  • POSTCreate provisioning/auditLogs/provisioning
  • GETGet provisioning/auditLogs/provisioning/:provisioningObjectSummary-id
  • DELETEDelete provisioning/auditLogs/provisioning/:provisioningObjectSummary-id
  • PATCHUpdate provisioning/auditLogs/provisioning/:provisioningObjectSummary-id

Audit logs: directory audits

  • GETList directory audits/auditLogs/directoryAuditsGet a list of directoryAudit objects representing the audit logs generated by Microsoft Entra ID. This includes audit logs generated by various services…
  • POSTCreate directory audit/auditLogs/directoryAudits
  • GETGet directory audit/auditLogs/directoryAudits/:directoryAudit-idGet a specific directoryAudit item. This includes an audit log item generated by various services within Microsoft Entra ID like user, application, device and…
  • DELETEDelete directory audit/auditLogs/directoryAudits/:directoryAudit-id
  • PATCHUpdate directory audit/auditLogs/directoryAudits/:directoryAudit-id

Reports: authentication methods

  • GETList authentication methods/reports/authenticationMethodsContainer for navigation properties for Microsoft Entra authentication methods resources.
  • DELETEDelete authentication methods/reports/authenticationMethods
  • PATCHUpdate authentication methods/reports/authenticationMethods
  • GETList user registration details/reports/authenticationMethods/userRegistrationDetailsGet a list of the authentication methods registered for a user as defined in the userRegistrationDetails object. This method doesn't work for disabled users.
  • POSTCreate user registration detail/reports/authenticationMethods/userRegistrationDetails
  • GETUsers registered by method (authentication method)/reports/authenticationMethods/usersRegisteredByMethod()Get the number of users registered for each authentication method.
  • GETUsers registered by feature (authentication method)/reports/authenticationMethods/usersRegisteredByFeature()Get the number of users capable of multi-factor authentication, self-service password reset, and passwordless authentication.
  • GETGet authentication method/reports/authenticationMethods/usersRegisteredByMethod(includedUserTypes=':includedUserTypes',includedUserRoles=':includedUserRoles')
  • GETGet authentication method/reports/authenticationMethods/usersRegisteredByFeature(includedUserTypes=':includedUserTypes',includedUserRoles=':includedUserRoles')
  • GETGet user registration detail/reports/authenticationMethods/userRegistrationDetails/:userRegistrationDetails-idRead the properties and relationships of a userRegistrationDetails object.
  • DELETEDelete user registration detail/reports/authenticationMethods/userRegistrationDetails/:userRegistrationDetails-id
  • PATCHUpdate user registration detail/reports/authenticationMethods/userRegistrationDetails/:userRegistrationDetails-id

Reports: daily print usage by user

  • GETGet daily print usage by user/reports/dailyPrintUsageByUserRetrieve a list of daily print usage summaries, grouped by user.
  • POSTCreate daily print usage by user/reports/dailyPrintUsageByUser
  • GETGet daily print usage by user/reports/dailyPrintUsageByUser/:printUsageByUser-idRetrieve a user's usage summary for a particular time period. For descriptions of each endpoint, see printUsageByUser.
  • DELETEDelete daily print usage by user/reports/dailyPrintUsageByUser/:printUsageByUser-id
  • PATCHUpdate daily print usage by user/reports/dailyPrintUsageByUser/:printUsageByUser-id

Reports: monthly print usage by user

  • GETGet monthly print usage by user/reports/monthlyPrintUsageByUserRetrieve a list of monthly print usage summaries, grouped by user.
  • POSTCreate monthly print usage by user/reports/monthlyPrintUsageByUser
  • GETGet monthly print usage by user/reports/monthlyPrintUsageByUser/:printUsageByUser-idRetrieve a list of monthly print usage summaries, grouped by user.
  • DELETEDelete monthly print usage by user/reports/monthlyPrintUsageByUser/:printUsageByUser-id
  • PATCHUpdate monthly print usage by user/reports/monthlyPrintUsageByUser/:printUsageByUser-id

Reports: daily print usage by printer

  • GETGet daily print usage by printer/reports/dailyPrintUsageByPrinterRetrieve a list of daily print usage summaries, grouped by printer.
  • POSTCreate daily print usage by printer/reports/dailyPrintUsageByPrinter
  • GETGet daily print usage by printer/reports/dailyPrintUsageByPrinter/:printUsageByPrinter-idRetrieve a usage summary for a printer for a particular time period. For descriptions of each of the endpoints, see printUsageByPrinter.
  • DELETEDelete daily print usage by printer/reports/dailyPrintUsageByPrinter/:printUsageByPrinter-id
  • PATCHUpdate daily print usage by printer/reports/dailyPrintUsageByPrinter/:printUsageByPrinter-id

Reports: monthly print usage by printer

  • GETGet monthly print usage by printer/reports/monthlyPrintUsageByPrinterRetrieve a list of monthly print usage summaries, grouped by printer.
  • POSTCreate monthly print usage by printer/reports/monthlyPrintUsageByPrinter
  • GETGet monthly print usage by printer/reports/monthlyPrintUsageByPrinter/:printUsageByPrinter-idRetrieve a list of monthly print usage summaries, grouped by printer.
  • DELETEDelete monthly print usage by printer/reports/monthlyPrintUsageByPrinter/:printUsageByPrinter-id
  • PATCHUpdate monthly print usage by printer/reports/monthlyPrintUsageByPrinter/:printUsageByPrinter-id

API details

Base URL
https://graph.microsoft.com/v1.0
Authentication
OAuth 2.0 (authorization code, client credentials flows)
Operations
207 operations on 151 pathsGET 143PATCH 24DELETE 22POST 18
Main resources
Reports 104Reports: partners 45Reports: authentication methods 12Audit logs: sign ins 8Reports: security 6Audit logs: directory audits 5Audit logs: provisioning 5Reports: daily print usage by printer 5Reports: daily print usage by user 5Reports: monthly print usage by printer 5
Description format
OpenAPI 3.0.4, API version v1.0

How to test the Microsoft Graph: Audit logs and usage reports in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Microsoft Graph: Audit logs and usage reports collection, without the publisher's secrets.
  3. Add your credentialsThis API uses OAuth 2.0 (authorization code, client credentials flows). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “List reports” (GET /reports), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Microsoft Graph: Audit logs and usage reports?

Read sign-in logs, directory audit logs and provisioning logs, and Microsoft 365 usage and activity reports. This listing is one area of Microsoft Graph, the… It is listed under Data & analytics and has 207 endpoints.

Who publishes the Microsoft Graph: Audit logs and usage reports?

It is listed from Microsoft's public API description (an OpenAPI document), not published by Microsoft on Swastik Codes. Anyone who controls microsoft.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Microsoft Graph: Audit logs and usage reports?

Requests go to https://graph.microsoft.com/v1.0. Endpoint paths are added to this base URL.

How do I authenticate with the Microsoft Graph: Audit logs and usage reports?

With OAuth 2.0 (authorization code, client credentials flows).

How many endpoints does the Microsoft Graph: Audit logs and usage reports have?

207 operations on 151 paths (143 GET, 24 PATCH, 22 DELETE, 18 POST). The largest groups are Reports, Reports: partners, Reports: authentication methods, Audit logs: sign ins.

Is forking the Microsoft Graph: Audit logs and usage reports free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.