Cloud Services API ReferenceGeneral ServiceDevice Cloud-to-Cloud Integration ServiceDevice Cloud to Cloud IntegrationGet Device Information

Get Device Information

Last Updated on : 2023-06-20 12:39:05

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 name	Type	IN	Required	Description
third_cloud_device_id	String	uri	true	The unique ID of a partner's device.

Return parameter

Parameter name	Type	Description
result	Object	The response result.
code	String	The response code. It is empty when the request succeeded.
msg	String	The message that is returned if the request fails. It is empty if the request is successful.
success	Boolean	Indicates whether the request is successful. Valid values: `true`: success. `false`: failure.
t	Long	The 13-digit timestamp of a response.

Description of result

Parameter name	Type	Description
device_id	String	The ID of the specified Tuya-enabled device.
device_name	String	The name of the specified device.
uuid	String	The universally unique identifier (UUID) of the specified device.
product_id	String	The product ID (PID).
create_time	Long	The 13-digit timestamp when the specified device is registered.
short_url	String	The 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.

Prev DocReport Device Response

Next DocUpdate Device Information