Working with the authentication methods usage report API
APIs under the
/beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.
The authentication methods usage reports help you understand how users in your organization use Azure Active Directory (Azure AD) features such as Multi-Factor Authentication (MFA), Self-Service Password Reset (SSPR), and Passwordless authentication.
These reports provide information such as:
- How many users are registered for each authentication method
- How many users are registered for features such as Multi-Factor Authentication (MFA), Self-Service Password Reset (SSPR), and Passwordless authentication.
- The failure rates of each authentication method
The following permissions are required to call this API. To learn more, including how to choose permissions, see Permissions.
|Permission type||Permissions (from least to most privileged)|
|Delegated (work or school account)||Reports.Read.All, AuditLog.Read.All|
|Delegated (personal Microsoft account)||Not supported.|
In order to access the API, one of the following roles is required:
- Reports reader
- Security reader
- Security admin
- Global reader
- Global admin
An Azure AD Premium P1 or P2 license is required to access usage and insights. Azure AD Multi-Factor Authentication and self-service password reset (SSPR) licensing information can be found on the Azure Active Directory pricing site.
The following table lists some common requests that you can use with this API.
|Operation||Try in Graph Explorer||Description|
|getCredentialUserRegistrationcount||GET /credentialuserregistrationcount||Get the number of users registered for self-service password reset and MFA.|
|getCredentialUsageSummary||GET /credentialusagesummary||Get the number of users using self-service password reset.|
|credentialUserRegistrationDetails||GET /credentialuserregistrationdetails||Get the user details for self-service password reset and MFA registration activities.|
|userCredentialUsageDetails||GET /usercredentialusagedetails||Get user details for all self-service password reset activities.|
|usersRegisteredByFeature||GET /authenticationMethods/usersRegisteredByFeature||Get the number of users capable of multi-factor authentication, self-service password reset and passwordless authentication.|
|usersRegisteredByMethod||GET /authenticationMethods/usersRegisteredByMethod||Get the number of users registered for each authentication method.|
|userRegistrationDetails||GET /authenticationMethods/userRegistrationDetails||Get the MFA registration details for all users.|
- Learn how to deploy Azure Active Directory self-service password reset.
- Learn how to deploy Azure Active Directory MFA.
- Learn how to enable combined security info registration.