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
Asset ID asset_id:1234
Last sync sync:2013-10-12
See Date and time formats for more info about formatting date queries.
Date registered This field is not displayed on the Chrome OS 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
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
Location location:seattle
Notes note:"loaned from john"
Recent user recent_user:user@mydomain.com
Argument must be an email address
Serial number id:12345abcdefg
Partial serial number searches are supported, as long as you enter at least three characters in the serial number.
Status Provisioned devices: status:provisioned
Disabled devices: status:disabled
Deprovisioned devices: status:deprovisioned
User user:joe
user:"tom sawyer"
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

Date and time formats

  • Basic date/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