List query operators

The Chromeosdevices.list and Mobiledevices.list methods support the following operators for the query parameter so you can filter your device search.

Field	Examples
Status	Provisioned devices: `status:provisioned` Disabled devices: `status:disabled` Deprovisioned devices: `status:deprovisioned` Managed devices (non-deprovisioned): `status:managed`
Serial number	`id:12345abcdefg` Partial serial number searches are supported, as long as you enter at least three characters in the serial number.
Asset ID	`asset_id:1234`
Date registered	This field is not displayed on the ChromeOS settings page. However, you can search for devices that were registered on a given date, or within a given time range. See Date and time formats for more info about formatting date queries. `register:2013-03-23`
Last sync	`sync:2013-10-12` See Date and time formats for more info about formatting date queries.
User	`user:joe` `user:"tom sawyer"`
Location	`location:seattle`
Notes	`note:"loaned from john"`
Model	`public_model_name:"Google Pixelbook Go"` Partial model name searches are supported.
MEID or IMEI	`meid:123456789` Partial MEID or IMEI searches are supported.
Last user activity	`last_user_activity:2023-06-12..2023-06-31` See Date and time formats for more info about formatting date queries.
OS update status	Up to date: `update_status:default_os_up_to_date` Updating: `update_status:pending_update` Updating (download not started): `update_status:os_image_download_not_started` Updating (download in progress): `update_status:os_image_download_in_progress` Updating (pending reboot): `update_status:os_update_need_reboot`
OS version compliance	Compliant: `compliance:compliant` Pending update: `compliance:pending_update` Not compliant: `compliance:not_compliant`
OS policy support status	All policies supported: `policy_status:false` Policies not supported: `policy_status:true`
Device type	Enterprise upgrade: `sku:enterprise` Education upgrade: `sku:education`
Upgrade type	Enterprise or EDU Upgrade (standalone): `license_sku:standalone_chrome_enterprise_upgrade` Enterprise or EDU Upgrade (bundled): `license_sku:chrome_enterprise_upgrade_bundled` Kiosk & Signage Upgrade (standalone): `license_sku:standalone_kiosk_and_signage_upgrade`
Chrome version	`chrome_version:111.012` Partial Chrome version searches are supported.
Chrome version (prefix)	`chrome_version:111;prefix` Search by Chrome version prefix.
Auto-update Expiration	`aue:2023-1-1..2023-12-31` See Date and time formats for more info about formatting date queries.
Most recent user	`recent_user:user@mydomain.com` Argument must be an email address
WiFi MAC Address	Address should be entered without spaces or colons. Partial address matching is not supported. Be aware that multiple devices may report the same address to the Admin console, and more than one result may be returned. `wifi_mac:6c2995724c50`
Ethernet MAC Address	Address should be entered without spaces or colons. Partial address matching is not supported. Be aware that multiple devices may report the same address to the Admin console, and more than one result may be returned. `ethernet_mac:e8ea6a157981`
CPU model name	`cpu_model_name:Intel` Partial CPU model name searches are supported.
System storage	`ram:68719476736..69793218560` System storage in bytes. See Number range formats for more info about formatting number queries.
Total Ram	`ram:3221225472..5368709120` Total Ram in bytes. See Number range formats for more info about formatting number queries.
Boot Mode	Verified: `boot_mode:Verified` Developer: `boot_mode:Dev`

Date and time formats

Basic date or time: YYYY-MM-DD or YYYY-MM-DDThh:mm:ss
Before a date: ..YYYY-MM-DD
After a date: YYYY-MM-DD..
Within a date range: YYYY-MM-DD..YYYY-MM-DD

Number range formats

Less than: ..222222
Greater than: 111111..
Between: 111111..222222