Global Error Codes
Last Updated on : 2022-11-22 02:55:47download
If errors occur in API requests, custom error messages will be returned. This topic describes different error codes and their error messages. You can also submit a ticket to request technical support.
System error codes
System error codes start with 500, 10xx, and 11xx. System errors might be caused by signatures, wrong parameters, and system timeout.
| Error code | Error message | Description |
|---|---|---|
| 500 | system error, please contact the admin | The business application network is unavailable or the interface times out. |
| 1000 | data not exist | The data does not exist. |
| 1001 | secret invalid | The secret is invalid. |
| 1002 | access_token is null | The token is null. |
| 1003 | grant type invalid | The authorization type is invalid. |
| 1004 | sign invalid | The signature is invalid. |
| 1005 | clientId invalid | The value of clientid is invalid. |
| 1006 | not support content type | The content type is not supported. |
| 1007 | not support key | The key is not supported. |
| 1008 | invalid access | The value of accessid is invalid. |
| 1010 | token is expired | The token has expired. |
| 1011 | token invalid | The token is invalid. |
| 1012 | token status is invalid | The token status is invalid. |
| 1013 | request time is invalid | The request timestamp has expired. |
| 1100 | param is empty | The specified parameters are empty. |
| 1101 | params range invalid | The parameter range is invalid. |
| 1102 | param is null | The parameter is null. |
| 1103 | commands issue error | The specified command is invalid. |
| 1104 | type is incorrect | The type is incorrect. |
| 1105 | missing the header | The header is missing. |
| 1106 | permission deny | The permission request is denied. |
| 1107 | code invalid | The authorization code is invalid. |
| 1108 | uri path invalid | The value of uri is invalid. |
| 1109 | param is illegal, please check it | The parameter is illegal. |
| 1110 | concurrent request over limit | The number of concurrent requests exceeds the upper limit. |
| 1111 | system is busy, please retry later | The system is busy. |
| 1112 | the user is syncing in the background, please try again later | The user is synchronizing data in the background. |
| 1113 | do not repeat the operation in a short time | Do not repeat the operation. |
| 1114 | your ip(%s) don’t have access to this API | This IP address is not included in the allowlist or has no access to this API. |
| 1199 | your requests are too frequent | Your requests are too frequent. |
| 1400 | token invalid | The token is invalid. |
Service error codes
Service error codes start with 20x and 21x. Service errors might be caused by device offline issues, users’ data issues, and task operation issues.
| Error code | Error message | Description |
|---|---|---|
| 2001 | device is offline | The device gets offline. |
| 2002 | this user dosen’t have any devices | The user does not have any devices. |
| 2003 | function not support | The specified feature is not supported. |
| 2004 | not support the lock type | The lock type is not supported. |
| 2005 | product not exist | The specified product does not exist. |
| 2006 | user not exist | The specified user does not exist. |
| 2007 | device token expired | The device token has expired. |
| 2008 | command or value not support | The command or value is not supported. |
| 2009 | not support this device | This type of device is not supported. |
| 2010 | device not exist | The specified device does not exist. |
| 2012 | application not support | The application is not supported. |
| 2013 | add timer failed | Failed to add a scheduled task. |
| 2014 | this device dosen’t have any timers | The device does not have a scheduled task. |
| 2015 | this category is not supported | The category is not supported. |
| 2016 | remote control is removed or does not exist | The remote control is removed or does not exist. |
| 2017 | schema does not exist | The app schema does not exist. |
| 2018 | data decrypt failed | Failed to decrypt the data. |
| 2019 | time over two hours | The period is more than two hours. |
| 2020 | Only third-party clouds are supported | Only third-party clouds are supported. |
| 2021 | Illegal email | The email address is incorrect. |
| 2022 | Illegal phone | The mobile phone number is incorrect. |
| 2023 | user exist | The user already exists. |
| 2024 | device file path is not standardized | The file path on the device is invalid. |
| 2025 | device and file path mismatch | The device and file path do not match. |
| 2026 | ip failed to get | Failed to get the IP address. |
| 2027 | size too large | The size is too large. |
| 2028 | encryption token expire | The token has expired. |
| 2029 | session status is invalid | The session status is invalid. |
| 2030 | virtual scan only support ay region | The virtual scanning is currently only available in China Data Center. |
| 2031 | third-party platform authorization failed | Third-party authorization failed. |
| 2032 | app pushed request unique ID is duplicate | The request_id already exists. Idempotency is required. |
| 2033 | more than 1000 app message push users | The number of users who receive the app push messages exceeds the upper limit. |
| 2037 | the username has been bound by another username type | The username has already been bound with another username type. |
| 2041 | operator name is exist | The operator’s username already exists. |
| 2042 | operator not exist | The operator does not exist. |
| 2043 | operator uuid not exist | The operator’s UUID does not exist. |
| 2044 | operator ip not exist | The operator’s IP address does not exist. |
| 2045 | operator ip has bind | The operator’s IP address has already been bound. |
| 2046 | operator uuid has bind | The operator’s UUID has already been bound. |
| 2047 | this device is freeze by user, can not command | The device is frozen. |
| 2050 | the infrared code corresponding to the key does not exist | The specified infrared code does not exist. |
| 2051 | send infrared command failed | Failed to send infrared commands. |
| 2052 | not support the command to set specific temperature | The command to set a specified temperature is not supported. |
| 2053 | the matching infrared code is invalid | The specified infrared code is invalid. |
| 2054 | the sub device is not exist | The sub-device does not exist. |
| 2055 | not support the device | This device is not supported. |
| 2056 | device has bind or not active | The device has already been bound or it is inactive. |
| 2060 | failed to add user, please try it later | Failed to add the user. |
| 2061 | message push config are not set | The push notification configuration is not completed. |
| 2062 | data already exists | The data already exists. |
| 2063 | other zigbee device is upgrading | Another Zigbee device is being updated. |
| 2064 | device version is the latest | The device version is up-to-date. |
| 2101 | duplicate naming under the device | The device name already exists. |
Is this page helpful?
YesFeedbackIs this page helpful?
YesFeedbackMarketing Cooperation
Business Cooperation
Customer Service
Media Inquiry
© 2023 Tuya Inc.