<iframe src="https://www.googletagmanager.com/ns.html?id=GTM-M74D8PB" height="0" width="0" style="display:none;visibility:hidden">
Loading
Skip to NavigationSkip to Main Content
Missing Enrolled Factors in Okta MFA API Response
Okta Identity Engine
Multi-Factor Authentication
Overview

This article explains why certain enrolled Multi-Factor Authentication (MFA) factors do not appear in the response to an API call, even when they are visible in the user profile in the Admin Console.

 

The issue occurs when performing the following GET request to retrieve a list of factors for a specific user:

{{url}}/api/v1/users/{{userId}}/factors

While the user appears to be enrolled in factors like phone, call, or SMS in the MFA Report or the Reset Authenticators menu, these factors are missing from the API output.

Applies To
  • MFA API
  • Multi-Factor Authentication (MFA)
  • Enrollment Policies
  • Okta Identity Engine (OIE)
Cause

The factors are missing from the API response because the enrollment policy was changed after the user enrolled. If a factor is currently disabled in the active enrollment policy, the API does not return it in the list of enrolled factors, even if the user has a legacy enrollment.

Solution

To resolve this issue, verify and update the enrollment policy settings:

  1. Sign in to the Okta Admin Console.
  2. Go to Security > Authenticators > Enrollment policy.
  3. Locate the enrollment policy applied to the affected user.
  4. Check if the missing factors are set to Disabled.
  5. To make the factors visible in the API response, change the factor requirement to Optional or Required.
  6. Select Save to apply the changes.
Loading
Missing Enrolled Factors in Okta MFA API Response