Use search operators to find devices

When you search for devices, you can include search operators with a search term to narrow your search results. To use the operators in a search, see the search procedure outlined at Search for devices with common criteria

You can use some search terms without a search operator to perform a global search. For example, you can search for the serial number with or without the serial: operator, and the results are similar.

When you use search operators, keep the following in mind:

  • Always include a colon (:) immediately after the operator.
  • Make sure there are no spaces between the operator and the value—for example, status:pending.
  • Enter dates and times using the formats in the following table: 
Form Searches Sample searches
datetime Exactly on the given date or time 2016-03-23
2016-04-26T14:23:05
datetime..datetime Within (inclusive) the given interval of date or time 2016-03-23..2011-04-26
datetime.. On or after the given date or time 2016-04-26T14:23:05..
..datetime On or before the given date or time ..2016-04-26T14:23:05

Search operators

Company-owned device search operators
Syntax Searches for Sample searches Global search
serial:string The device’s serial number serial:015d3fb66e241807 Yes
status:status Devices with the given provisioning status

Supported values:

  • approved
  • not_in_use
  • blocked
No
sync:time_range Devices whose last policy sync was in the given time range
 
sync:2017-03-23
sync:2017-03-23..2017-04-05
No
type:string Type of device type:android No
Personal device search operators
Syntax Description and usage Global search Management type
apps:app

Apps on users' Android devices if application auditing is turned on (see Android settings page > General settings)

Examples:

apps:Calendar
apps:com.android.mms
apps:4.0.4-253145

No Advanced
bootloader_version:string

Bootloader version on Android devices

Example:

bootloader_version:BHZ11e

No Advanced
brand:string

Brand name

Example:

brand:google

Yes Advanced
build_number:string

Build number

Example:

build_number:6.7.2_EDEM-18

No Advanced
carrier:string

Name of the mobile operator of the given device

Example:

carrier:Airtel

No Advanced
compromised_status:string

Compromised device status

Examples:

compromised_status:compromised compromised_status:uncompromised compromised_status:undetected

No Advanced
default_language:string

Language settings on the device

Example:

default_language:English

No Advanced
email:address

Email address (as a phrase)

Example:

email:joe@example.com (matches joe.sabia@example.com and joe.sciarrillo@example.org)

Yes Basic and advanced
encryption_status:string

Encryption status of an Android device

Examples:

encryption_status:encrypted
encryption_status:not_encrypted
encryption_status:unsupported

No Advanced
hardware:string

Hardware for an Android device

Example:

hardware:bullhead

Yes Advanced
hid:string

Hardware ID

Example:

hid:A0000292789YD

Yes Advanced
id:string

Alphanumeric string (with numbers and alphabetic characters) that identifies this device for mobile device management.

Example:

id:12345ABCDEFXYZ

Yes Advanced
imei:string

International Mobile Equipment Identity (IMEI) number of the device

Example:

imei:353020051574987

Yes Advanced
kernel_version:string

Kernel version

Example:

kernel_version:3.1.10-g1e42d16

No Advanced
mac_address:string

WiFi MAC address of the device

Example:

mac_address:30:85:a9:59:d5:ed

Yes Advanced
management_type:string

Devices managed by the specified management type.

Examples:

management_type:advanced
management_type:basic

No Basic and advanced
manufacturer:string

Manufacturer of an Android device

Example:

manufacturer:LGE

Yes Advanced
meid:string

Mobile Equipment Identifier (MEID) of the device; only for Code Division Multiple Access (CDMA) devices

Example:

meid:A0954742789012

Yes Advanced
model:name

Name of the device model

Example:

model:nexus s

Yes Advanced
name:words

Given words in usernames

Examples:

name:joe (matches name Joe Sabia but not Joel Ortiz)
name:Joe Sabia (matches name Joe Sabia and Joe Sabia Daniels but not Joey Sabia or Joe The Pun Champ Sabia)

Yes Advanced
os:name

Name of the mobile operating system

Examples:

os:Android
os:ios 9

Yes Advanced
password_status:
boolean

Password status of an Android 6.0+ device

Examples:

password_status:on
password_status:off
 

No Advanced
privilege​:string

Android devices that have a work profile set up

Syntax:

privilege:device_owner – Find corporate-owned devices configured to recognize the company as the device owner

privilege:profile_owner – Find users’ personal devices configured with managed work profiles that are separate from their personal space

privilege:device_admin – Find users’ personal devices configured with managed accounts within their personal space

No Basic and advanced
register:time_range

Devices that were registered in the given time range

Examples:

register:2017-03-23
register:2017-04-05T13:42:00

No Advanced
security_patch_level:date

Date of the last OS security update for an Android 6.0+ Marshmallow device

Examples:

security_patch_level:2017-08-05 security_patch_level:2017-08-05..
2017-09-05

No Advanced
serial:string

Device serial number

Example:

serial:015d3fb66e241807

Yes Advanced
status:status

Devices with the given G Suite provisioning status

Examples:

status:pending
status:approved
status:account_wiped

Supported values: account_wiped, 
account_wiping, approved, blocked, pending, unprovisioned, wiped, wiping 

No Basic and advanced
sync:time_range

Devices whose last policy sync was in the given time range

Examples:

sync:2017-03-23
sync:2017-03-23..2017-04-05T13:42:00

No Basic and advanced
type:string

Type of device

Examples:

type:android
type:googlesync
type:ios

No Basic and advanced
Was this helpful?
How can we improve it?