Get Device List

Last Updated on : 2023-06-15 04:47:20

Get a list of devices that meet specific criteria under a project.

API address

GET: /v1.3/iot-03/devices

Request parameter

Parameter name	Type	IN	Required	Description
source_type	String	query	false	Includes devices at different dimensions. Valid values: `asset`: a device at the industry asset dimension. Default value. `homeApp`: a device that is linked with an app or mini program under the home system. `tuyaUser`: a device that is linked with an account of the Tuya Smart system. `product`: a device that is linked with a poduct.
source_id	String	query	false	A different business ID is entered depending on the `source_type`. Valid values: Pass in the asset ID at the `asset` dimension. Pass in the app schema at the `homeApp` dimension. Pass in the user ID (UID) at the `tuyaUser` dimension. Pass in the product ID at the `product` dimension.
device_ids	String	query	false	The list of device IDs. Maximum value: 20 each time.
name	String	query	false	The name of a specified device.
category	String	query	false	The category of a specified product.
product_id	String	query	false	The product ID.
last_row_key	String	query	false	The row key of the last page.
page_size	Integer	query	false	The number of items returned on each page. Default value: `20`. Maximum value: `200`.

Return parameter

Parameter name	Type	Description
result	CursorPage	The returned result.

Description of result

Parameter name	Type	Description
has_more	Boolean	Specifies whether to return the next page.
list	List	The list of returned data.
last_row_key	String	The row key of the last page.
total	Long	The total entries of data that meets the criteria.

Description of list

Parameter name	Type	Description
id	String	The device ID.
gateway_id	String	The gateway ID. The value is empty for non-gateway sub-devices.
node_id	String	The node ID. The value is empty for non-gateway sub-devices.
uuid	String	The universally unique identifier (UUID) of a device.
category	String	The category of a specified product.
category_name	String	The name of a specified product category.
name	String	The name of a specified device.
product_id	String	The product ID.
product_name	String	The product name.
local_key	String	The secret key.
sub	Boolean	Indicates whether it is a sub-device.
asset_id	String	The asset ID.
owner_id	String	The home ID.
ip	String	The IP address of a specified device.
lon	String	The longitude.
lat	String	The latitude.
model	String	The product model.
time_zone	String	The time zone.
active_time	Long	The time when a device is activated.
update_time	Long	The time when a device is updated.
create_time	Long	The time when the device is paired for the first time.
online	Boolean	The online status of a specified device.
icon	String	The device icon.

Request example

GET: /v1.3/iot-03/devices?category=xx&product_id=xx&name=xx&device_ids=xx&last_row_key=xx&page_size=xx

Return example

{
    "result": {
        "last_row_key": "B4C4EBD263D95628587B9643840E****",
        "list": [
            {
                "sub": false,
                "category_name": "Light Source",
                "create_time": 1567395627,
                "local_key": "8ab649951d59****",
                "owner_id": "3125****",
                "ip": "124.90.34.***",
                "icon": "smart/icon/1526276264k8q8l44swr2ennf6zx5u92***_0.png",
                "lon": "120.0***",
                "time_zone": "+08:00",
                "product_name": "Light",
                "uuid": "38042025cc50e325****",
                "gateway_id": "",
                "active_time": 1620299529,
                "update_time": 1635939139,
                "product_id": "ylr9R01cMWnM****",
                "name": "Light",
                "online": false,
                "model": "LE7",
                "id": "38042025cc50e325****",
                "category": "dj",
                "lat": "30.3***"
            }
        ],
        "total": 34,
        "has_more": true
    },
    "t": 1635940989216,
    "success": true
}

Error code

For more information, see error code.

Prev DocGeneral Device Management

Next DocBulk Delete Devices