Get a device

GET /clip/v2/resource/device/device_uuid

Get a device by UUID. The device is returned in data.obj and uses the same fields as List devices.

If the UUID does not exist, the gateway returns 404 Not Found.

Example response

{
  "code": 0,
  "msg": "success",
  "data": {
    "obj": {
      "id": "27968061-68C1-4538-83AF-88E390FD8933",
      "type": "device",
      "name": "Bar Lamp",
      "join_status": 1,
      "online": 1,
      "has_new": 0,
      "product": {
        "cat1_id": 2,
        "cat1_name": "Light",
        "cat2_id": 205,
        "cat2_name": "RGB CW Light",
        "cat3_id": 20504,
        "cat3_name": "Bar Lamp",
        "manufacturer": "Bweetech",
        "model": "915005988001",
        "hardware_version": "6",
        "software_version": "",
        "zigbee_version": "4.8.8_46"
      },
      "services": [
        {
          "rid": "8C3C3D02-A008-44F2-9C6A-146705167EB3",
          "rtype": "light"
        }
      ]
    }
  }
}

{
  "code": -1,
  "msg": "not found"
}

Responses

Status code	Meaning
200	OK

Response fields

HTTP 200 OK

Field	Type	Required	Description
code	integer	Yes	Result code.
msg	string	Yes	Response message.
data	object	Yes	Response payload.
data.obj	object	Yes	Returned resource.
data.obj.id	string	Yes	Device UUID
data.obj.type	string	Yes	Always device.
data.obj.name	string	Yes	Name
data.obj.join_status	integer	Yes	Filter for join_status=1 to show devices the user has added. A value of 0 identifies a device that has not been selected.
data.obj.online	integer	Yes	1 if online; 0 if offline.
data.obj.has_new	integer	Yes	1 if an update is available; otherwise 0.
data.obj.product	object	Yes	Product information
data.obj.product.cat1_id	integer	Yes	Level 1 category ID. 1: gateway; 2: light; 3: sync device.
data.obj.product.cat1_name	string	Yes	Level 1 category name
data.obj.product.cat2_id	integer	Yes	Product category ID; for example, 203 for CW lights or 205 for RGBCW lights.
data.obj.product.cat2_name	string	Yes	Level 2 category name
data.obj.product.cat3_id	integer	Yes	Product-specific category ID; for example, 20504 for a Bar light.
data.obj.product.cat3_name	string	Yes	Level 3 category name
data.obj.product.manufacturer	string	Yes	Manufacturer reported by the Zigbee Basic cluster.
data.obj.product.model	string	Yes	Model reported by the Zigbee Basic cluster.
data.obj.product.hardware_version	string	Yes	Hardware version
data.obj.product.software_version	string	Yes	Software version
data.obj.product.zigbee_version	string	Yes	Zigbee version
data.obj.services	ResInfo[]	Yes	—
data.obj.services[].rid	string	Yes	Resource UUID
data.obj.services[].rtype	string	Yes	Resource type