List Devices Using Query by Tag

The following example shows how to list all devices that are tagged with a specific tag.

Request

GET /ws/v1/devices/inventory?query=tags='myTag'

Response

{
  "count" : 3,
  "size" : 1000,
  "list" : [ 
  {
    "channels_uri" : "/ws/v1/devices/channels/8C1C080F-A8214448-2674ED16-B9196C0E",
    "metrics_uri" : "/ws/v1/devices/metrics/8C1C080F-A8214448-2674ED16-B9196C0E",
    "group" : "",
    "management_uri" : "/ws/v1/devices/management/8C1C080F-A8214448-2674ED16-B9196C0E",
    "type" : " ",
    "connection_status" : "disconnected",
    "id" : "8C1C080F-A8214448-2674ED16-B9196C0E",
    "restricted_status" : "unrestricted",
    "tags" : [ "myTag" ],
    "health_status" : "unknown",
    "maintenance_mode" : "off"
  }, 
  {
    "channels_uri" : "/ws/v1/devices/channels/BD2EA7BE-60DF46A6-EBBF5052-5B9217FC",
    "metrics_uri" : "/ws/v1/devices/metrics/BD2EA7BE-60DF46A6-EBBF5052-5B9217FC",
    "group" : "",
    "management_uri" : "/ws/v1/devices/management/BD2EA7BE-60DF46A6-EBBF5052-5B9217FC",
    "type" : " ",
    "connection_status" : "disconnected",
    "id" : "BD2EA7BE-60DF46A6-EBBF5052-5B9217FC",
    "restricted_status" : "unrestricted",
    "tags" : [ "myTag" ],
    "health_status" : "unknown",
    "maintenance_mode" : "off"
  }, 
  {
    "channels_uri" : "/ws/v1/devices/channels/BF652035-B3BA464A-B5C95C90-770A4838",
    "metrics_uri" : "/ws/v1/devices/metrics/BF652035-B3BA464A-B5C95C90-770A4838",
    "group" : "",
    "management_uri" : "/ws/v1/devices/management/BF652035-B3BA464A-B5C95C90-770A4838",
    "type" : " ",
    "connection_status" : "disconnected",
    "id" : "BF652035-B3BA464A-B5C95C90-770A4838",
    "restricted_status" : "unrestricted",
    "notes" : "yo",
    "tags" : [ "myTag" ],
    "health_status" : "unknown",
    "maintenance_mode" : "off"
  } ]
}