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.