English
English
简体中文
Contact Us
Register
Log In

Get Device Information

Last Updated on : 2022-05-05 10:00:33

Get the information of a specified device in Tuya's ecosystem based on the partner's device ID.

API address

GET: /v1.0/iot-03/3rdcloud/devices/{third_cloud_device_id}

Request parameter

Parameter nameTypeINRequiredDescription
third_cloud_device_idStringuritrueThe unique device ID of a partner.

Return parameter

Parameter nameTypeDescription
resultObjectThe returned result.
codeBooleanThe response code. It is empty when the operation succeeded.
msgStringThe error message if the API call fails. It is empty if the operation succeeded.
successBooleanIndicates whether the operation is successful. Valid values:
  • true: success
  • false: failure.
tLongThe 13-digit timestamp of a response.

Description of result

Parameter nameTypeDescription
device_idStringThe ID of a Tuya device.
device_nameStringThe name of a specified device.
uuidStringThe universally unique identifier (UUID) of a specified device.
product_idStringThe ID of a specified product.
create_timeLongThe 13-digit timestamp when a specified device is registered.

Request example

GET: /v1.0/iot-03/3rdcloud/devices/A18007210830****

Return example

{
    "result": {
        "device_id": "6cf4171005d11e2ca7****",
        "create_time": 1593314585000,
        "uuid": "000078082462ab53****",
        "device_name": "Test Device",
        "product_id": "xz0uukkq5oce****"
    },
    "t": 1561456817168,
    "success": true
}

Error code

For more information, see error code.