Query Latest Device Information by UUID

Last Updated on : 2026-06-23 10:13:03Copy for LLMView as MarkdownDownload PDF

Query the basic device information by the device universally unique identifier (UUID). Pass the device UUID as the request parameter. The server returns the device's cloud ID, name, category, online status, bound space, and other related information. If the UUID is empty, parameter validation fails. If the device does not exist, has been unbound, or has been deleted, a null value is returned (or the corresponding business error code).

API address

GET: /v2.0/cloud/thing/last/{uuid}

Request parameter

Parameter name	Type	IN	Required	Description
uuid	String	path	true	The UUID of the device.

Return parameter

Parameter name	Type	Description
result	DeviceFusionVO	The list of returned data.
success	Boolean	Indicates whether the operation is successful. Valid values: `true`: success. `false`: failure.
t	Long	The timestamp.
tid	String	The link ID.

Description of result

Parameter name	Type	Description
id	String	The device ID.
bind_space_id	String	Bind the space ID of a room.
active_time	Long	The time when the specified device is activated, which is accurate to seconds.
category	String	The product category of the device.
create_time	Long	The time when the device is first paired, which is accurate to seconds.
update_time	Long	The time when the device is updated, which is accurate to seconds.
custom_name	String	The custom name of the device.
icon	String	The device icon.
ip	String	The IP address of the device.
is_online	Boolean	The online status of the device.
lat	String	The latitude of the device.
local_key	String	The unique encrypted key of the specified device over LAN.
lon	String	The longitude of the device.
name	String	The device name.
product_id	String	The product ID of the device.
product_name	String	The product name of the device.
sub	Boolean	Indicates whether it is a sub-device.
time_zone	String	The time zone of the device.
uuid	String	The UUID of the device.

Request example

GET: /v2.0/cloud/thing/last/vdevo165abcd98***

Return example

{
  "result": {
    "active_time": 1676972970,
    "bind_space_id": "123456***",
    "category": "cz",
    "create_time": 1676972970,
    "custom_name": "Test device 1",
    "icon": "smart/icon/bay1634643319171hln1/8dee77c5e5272511c332d1***.png",
    "id": "vdevo165abcd98***",
    "ip": "",
    "is_online": true,
    "lat": "",
    "local_key": "xxxx",
    "lon": "",
    "model": "AE434",
    "name":"Socket"
    "product_id": "m1rdbmka",
    "product_name": "Socket",
    "sub": false,
    "time_zone": "",
    "update_time": 1677206700,
    "uuid": "vdevo165abcd98***"
  },
  "success": true,
  "t": 1781592659165,
  "tid": "bb3742c6694f11f18368e250dded724c"
}

Error code

For more information, see error code.

Prev DocGet Status Reporting Log

Next DocDevice Control