List Device Users

Lists users for a device in Okta.

The action returns a maximum of 20 users who are associated with a device, even though there may be more than 20 users assigned to the device.

Input

Field Definition Type Required

Device

ID

Unique identifier of the device.

Text

TRUE

Output

Field Definition Type

Result

Users

List of Objects

ID

Identifier of the Okta user.

Text

Realm ID

Identifier of the Okta realm where the user resides.

Text

Status

Status of the user.

These are the possible values:

  • STAGED

  • PROVISIONED

  • ACTIVE

  • RECOVERY

  • LOCKED_OUT

  • PASSWORD_EXPIRED

  • SUSPENDED

  • DEPROVISIONED

Text

Status Changed

Date of the user's last status change.

Date & Time

Transitioning To Status

The target status for any in-progress asynchronous status transition. These are the possible values:

  • ACTIVE

  • DEPROVISIONED

  • PROVISIONED

This property is only returned if the user's state is in transition.

Text

Activated

Timestamp when the transition to ACTIVE status was completed.

Date & Time

Created

Timestamp when the user was created.

Date & Time

Last Login

Timestamp when the user last signed in.

Date & Time

Last Updated

Timestamp of the user's last update.

Date & Time

Password Changed

Timestamp of the user's last password change.

Date & Time

Credentials

An object representing the user's credentials.

Object

Password

This field is True if the user has a valid password or an imported hashed password.

True/False

Provider Name

The name of the authentication provider.

Text

Provider Type

The type of authentication provider.

These are the possible values:

  • ACTIVE_DIRECTORY

  • FEDERATION

  • IMPORT

  • LDAP

  • OKTA

  • SOCIAL

Text

Recovery Question

A recovery question that's provided when a user forgets their password.

Text

Profile

An object representing the default profile properties for a user.

Object

City

City or locality of the user's address.

Text

Cost Center

The name of a cost center assigned to the user.

Text

Country Code

Country abbreviation.

Text

Department

Name of the user's department.

Text

Display Name

Name of the user, as displayed to end users.

Text

Division

Name of the user's division.

Text

Primary Email

Primary email address of the user.

Text

Employee Number

The unique identifier for the user, as assigned to them by the organization or company.

Text

First Name

First name of the user.

Text

Honorific Prefix

Any honorific prefixes for the user, for example, Dr., Rev., Mr., or Ms.

Text

Honorific Suffix

Any honorific suffixes for the user, for example, Jr., Sr., or MBE.

Text

Last Name

Family name of the user.

Text

Locale

The default location of the user. This is used for localizing items like currency, date and time format, and numerical representations.

Text

Username

The sign-in username for the user, usually in the form of an email address.

Text

Manager

The display name of the user's manager.

Text

Manager ID

ID of the user's manager.

Text

Middle Name

User's middle name.

Text

Mobile Phone

The mobile phone number of the user.

Text

Nickname

If applicable, the user's preferred nickname.

Text

Organization

Name of the user's organization.

Text

Postal Address

Mailing address component of the user's address.

Text

Preferred Language

Preferred written or spoken languages of the user.

Text

Primary Phone

The primary phone number of the user, such as their home number.

Text

Profile URL

URL of the user's online profile or web page.

Text

Secondary Email

Secondary email address of the user. This is typically used for account recovery.

Text

State

State or region component of the user's address.

Text

Street Address

Full street address component of the user's address.

Text

Time Zone

Time zone where the user is located.

Text

Title

Job title of the user.

Text

User Type

User's relationship to the organization, for example, Employee or Contractor.

Text

Zip Code

A zip code or postal code component of the user's address.

Text

Type ID

The user type identifier that determines the schema for the user's profile.

Text

Embedded Resources

If specified, this object includes any embedded resources related to the user.

Object

Device

An object representing basic information about the device.

Object

Created

The timestamp when the device record was created.

Date & Time

Management Status

The management status of the device.

These are the possible values:

  • MANAGED

  • NOT_MANAGED

Text

Screen Lock Type

The type of screen locking present on the device.

These are the possible values:

  • NONE

  • PASSCODE

  • BIOMETRIC

Text

Related topics

Okta Devices connector

Okta Devices API

Device lifecycle

Cards in flows