Working with the authentication methods usage report API
Namespace: microsoft.graph
Important
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 are using Microsoft Entra authentication capabilities such as multifactor 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 multifactor authentication (MFA), Self-Service Password Reset (SSPR), and Passwordless authentication.
- The failure rates of each authentication method
Licenses
A Microsoft Entra ID P1 or P2 license is required to access usage and insights. Microsoft Entra multifactor authentication and self-service password reset (SSPR) licensing information can be found on the Microsoft Entra pricing site.
Common requests
The following table lists some common requests that you can use with this API.
Operation | Try in Graph Explorer | Description |
---|---|---|
usersRegisteredByFeature | GET /authenticationMethods/usersRegisteredByFeature | Get the number of users capable of multifactor 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. |
Related content
- Learn how to deploy Microsoft Entra self-service password reset.
- Learn how to deploy Microsoft Entra multifactor authentication.
- Learn how to enable combined security info registration.