Get Device Information

Last Updated on : 2023-05-23 08:00:21

Based on the partner's device ID, get the information about the specified device in Tuya's ecosystem.

API address

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

Request parameter

Parameter nameTypeINRequiredDescription
third_cloud_device_idStringuritrueThe unique ID of a partner's device.

Return parameter

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

Description of result

Parameter nameTypeDescription
device_idStringThe ID of the specified Tuya-enabled device.
device_nameStringThe name of the specified device.
uuidStringThe universally unique identifier (UUID) of the specified device.
product_idStringThe product ID (PID).
create_timeLongThe 13-digit timestamp when the specified device is registered.
short_urlStringThe short URL for device pairing.

Request example

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

Return example

{
    "result": {
        "device_id": "6cf4171005d11e2ca7****",
        "create_time": 1593314585000,
        "uuid": "000078082462ab53****",
        "short_url": "https://m.smart321.com/AYZy0o****",
        "device_name": "Test Device",
        "product_id": "xz0uukkq5oce****"
    },
    "t": 1561456817168,
    "success": true
}

Error code

For more information, see error code.