Skip to content

List all authenticators

Request

Identity Engine
OAuth 2.0 scope:
  • okta.authenticators.read

Lists all authenticators

Note: When the Flexible Okta Verify authenticator configuration feature is enabled, the response includes both the individual per-method authenticators (okta_verify_totp, okta_verify_push, okta_verify_fastpass) and a legacy okta_verify aggregate object for backward compatibility.

Flexible Okta Verify authenticator configuration is a self-service Early Access (EA) feature. See Manage Early Access and Beta features to enable the feature.

curl -i -X GET \
  https://subdomain.okta.com/api/v1/authenticators

Responses

Success

Bodyapplication/json
Array [
createdstring, (date-time)read-only

Timestamp when the authenticator was created

descriptionstring

The description of the authenticator. This setting is only available for the webauthn authenticator type (Passkeys).

idstringread-only

A unique identifier for the authenticator

keystring(AuthenticatorKeyEnum)

A human-readable string that identifies the authenticator

Enum:"custom_app""duo""external_idp""google_otp""okta_email""okta_password""okta_verify""onprem_mfa""phone_number""security_key"
Discriminator
lastUpdatedstring, (date-time)read-only

Timestamp when the authenticator was last modified

namestring

Display name of the authenticator

statusstring(LifecycleStatus)

Status of the authenticator

Enum:"ACTIVE""INACTIVE"
typestring(AuthenticatorType)

The type of authenticator

Enum:"app""email""federated""password""phone""security_key""security_question""tac""proximity"
agreeToTermsboolean

A value of true indicates that the administrator accepts the terms for creating a new authenticator. Okta requires that you accept the terms when creating a new custom_app authenticator. Other authenticators don't require this field.

providerobject
settingsobject
]
Response
[ { "type": "email", "id": "aut1nbsPHh7jNjjyP0g4", "key": "okta_email", "status": "ACTIVE", "name": "Email", "created": "2020-07-26T21:05:23.000Z", "lastUpdated": "2020-07-28T21:45:52.000Z", "settings": { … }, "_links": { … } }, { "type": "password", "id": "aut1nbtrJKKA9m45a0g4", "key": "okta_password", "status": "ACTIVE", "name": "Password", "created": "2020-07-26T21:05:23.000Z", "lastUpdated": "2020-07-26T21:05:23.000Z", "_links": { … } }, { "type": "phone", "id": "aut1nbuyD8m1ckAYc0g4", "key": "phone_number", "status": "INACTIVE", "name": "Phone", "created": "2020-07-26T21:05:23.000Z", "lastUpdated": "2020-07-29T00:21:29.000Z", "settings": { … }, "_links": { … } }, { "type": "security_key", "id": "aut1nd8PQhGcQtSxB0g4", "key": "webauthn", "status": "ACTIVE", "name": "Security Key or Biometric", "created": "2020-07-26T21:16:37.000Z", "lastUpdated": "2020-07-27T18:59:30.000Z", "_links": { … } } ]