
tuya 20250618 Cloud Services API Reference

Specifications
- Version: 20250618
- Online Version
Product Information
This product allows users to query the list of devices under a specified cloud project. Users can filter the device list by product ID and category using API requests.
Query the list of devices under a specified cloud project. You can filter the device list by product ID and category.
API address
![]()
Request parameter

Return parameter


Request example.
![]()
Return example

Error code
For more information, see error code.
Limits on API Request Frequency
For more information, see Limits on API Request Frequency.
Frequently Asked Questions
What are the maximum values for page_size parameter?
The maximum value for page_size is 20.
Can I filter the device list by multiple product IDs?
Yes, you can provide up to 5 product IDs separated by commas.
How can I check if a device is online?
The return example includes the 'isOnline' parameter, which indicates whether the specified device is online.
Documents / Resources
![]() | 20250618 Cloud Services API Reference |
References
- Query Devices in Project-Cloud Services API Reference-Tuya Developerdeveloper.tuya.com
- Global Error Codes-Tuya Developer Platform-Tuya Developerdeveloper.tuya.com
- Limits on API Request Frequency-Tuya Developer Platform-Tuya Developerdeveloper.tuya.com
- User Manualmanual.tools
Published: August 13, 2025
