Search Devices

Search for devices registered in Okta and return information about the device.

Scopes

See Action cards for the list of required OAuth scopes needed by this card.

Options

Field	Definition	Type	Required
Result Set	Choose one of the following options to display your search results: First Matching Record: Returns only the first record that matches the search query. First 200 Matching Records Stream Matching Records: Passes all matching records from your parent flow to a helper flow. Selecting this option adds a Streaming input section to the card where you can select a helper flow for streaming and add custom extensible fields.	Dropdown	TRUE

Field

Definition

Type

Required

Result Set

Choose one of the following options to display your search results:

First Matching Record: Returns only the first record that matches the search query.
First 200 Matching Records
Stream Matching Records: Passes all matching records from your parent flow to a helper flow.

Selecting this option adds a Streaming input section to the card where you can select a helper flow for streaming and add custom extensible fields.

Dropdown

TRUE

Input

If you specify multiple search criteria, they're combined to create the query. The resulting output is the group that matches all criteria.

However, if you don't specify any search criteria, the card returns all fields for available records.

Field	Definition	Type	Required
Profile
Disk Encryption Type	The type of encryption used on the device.	Text	FALSE
Manufacturer	Name of the manufacturer of the device.	Text	FALSE
Model	Model of the device.	Text	FALSE
OS Version	Version of the device operating system.	Text	FALSE
Platform	OS platform of the device. These are the possible values: MACOS WINDOWS ANDROID IOS	Text	FALSE
Registered	Indicates if the device is registered at Okta.	Text	FALSE
Secure Hardware Present	Indicates if the device contains a secure hardware functionality.	True/False	FALSE
Status	Current status of device. These are the possible values: CREATED ACTIVE SUSPENDED DEACTIVATED	Text	FALSE
Custom Search Criteria	A SCIM expression that filters the results. Searches include all device profile properties, the device ID, status, and last update properties.	Text	FALSE
Streaming
Flow	Click Choose Flow to browse and select a helper flow as the destination for the streamed search results. Click Choose to confirm. Optionally, you can click the empty field under Click or drop here to create to add custom extensible fields that pass data to the helper flow. These fields are added as key and value pairs under the State output object in the helper flow. This field appears when Stream Matching Records is selected from the Result Set field.	Flow	TRUE
Record Limit	Specify the maximum number of records to stream. When the Record Limit field is set to 0 or a negative number, the card returns an error. When the Record Limit field is set to greater than 0, the stream returns up to the maximum number specified. When the Record Limit field is empty, null, or not selected, the stream returns all records. The default value is 1000000 (1 million). The valid range is from 0 to 1000000. This field appears when Stream Matching Records is selected from the Result Set option.	Number	FALSE

Output

Field	Definition	Type
Device	Each object contains the details for an individual device. This field appears when you select First 200 Matching Records from the Result Set option.	List of Objects
ID	Unique identifier of the device.	Text
Created	Timestamp when the device was created.	Date & Time
Last Updated	Timestamp when the device record was last updated. Updates occur when Okta collects and saves device signals during authentication, and when the lifecycle state of the device changes.	Date & Time
Profile
Disk Encryption Type	Type of encryption used on the device.	Text
Display Name	The display name of the device.	Text
International Mobile Equipment ID	International Mobile Equipment Identity (IMEI) of the device.	Text
Integrity Jailbreak	Indicates if the device is jail-broken or rooted. Only applicable to iOS and Android platforms.	True/False
Manufacturer	Name of the manufacturer of the device.	Text
Mobile Equipment ID	Mobile equipment identifier of the device.	Text
Model	Model of the device.	Text
OS Version	Version of the device OS.	Text
Platform	OS platform of the device. These are the possible values: MACOS WINDOWS ANDROID IOS	Text
Registered	Indicates if the device is registered at Okta.	True/False
Secure Hardware Present	Indicates if the device contains a secure hardware functionality.	True/False
Serial Number	Serial number of the device.	Text
Security ID	Windows Security identifier of the device.	Text
Trusted Platform Module Hash	Windows Trusted Platform Module hash value.	Text
Unique Device ID	macOS Unique Device identifier.	Text
Resource Alternate ID		Text
Resource Display Name
Value	Text for the display name.	Text
Sensitive	Returns true if the display name is case-sensitive.	True/False
Resource ID	Alternate key for the ID.	Text
Resource Type	The default value is UDDevice.	Text
Status	Current status of device. These are the possible values: CREATED ACTIVE SUSPENDED DEACTIVATED	Text
Links	Specifies link relations (see Web Linking) available for the status of an application using the JSON Hypertext Application Language specification. This object is used for dynamic discovery of related resources and lifecycle operations.	Object
Result
Records Streamed	Number of records streamed in a streaming flow. This field appears when you select Stream Matching Records from the Result Set option.	Number

Search Devices

Scopes

Options

Input

Output

Related topics