This topic describes the latest error codes and receipt codes.

Note In order to improve customer experience, the Short Message Service will be optimized and upgraded for API and vendor error codes in 2020/08/13. The expired status will be added to the DLR status report with a status code of 6. Please pay attention to whether your system needs to be upgraded!

Common error codes

API error code Description Solution
OK No error occurred. -
SYSTEM_ERROR Internal system error. Please feedback the platform to solve.
NOT_SUPPORTED_COUNTRY Currently, SMS cannot be sent internationally over that country. Please feedback the platform to solve.
OUT_OF_SERVICE The international SMS service is down. Please feedback the platform to solve.
ACCOUNT_NOT_EXISTS The account information does not exist. Please confirm whether to activate the Short Message Service or contact the platform to solve the problem.
SMS_CONTENT_CODE_ILLEGAL The template is invalid (does not exist or is blacklisted). Apply for new template content.
SMS_SIGN_NAME_ILLEGAL The signature is invalid (does not exist or is blacklisted). Please apply for a new signature.
MOBILE_NUMBER_ILLEGAL The mobile number format error. Please verify the number format accuracy, resubmit to the platform.
MOBILE_COUNT_OVER_LIMIT The number of mobile phone numbers exceeds 1,000. Please control the number of calling batchAPI numbers within the range of 1000, and then resubmit it to the platform.
CONTENT_MISSING_PARAMETERS The corresponding parameter value of the template variable is missing. Please pass in the correct parameter value in the template variable.
INVALID_PARAMETERS The input parameter is abnormal. Check the parameter configurations to ensure parameter accuracy.
INVALID_JSON_PARAM The parameter is empty. The JSON string is incorrectly parsed. Check the parameter configurations to ensure parameter accuracy.
BLACK_KEY_CONTROL_LIMIT The blacklist keyword exists in the template variable. Check the template variable content compliance and submit again.
PARAM_LENGTH_LIMIT The length of the variable is limited. Contact Alibaba Cloud to remove the variable length limit.
AMOUNT_NOT_ENOUGH Account package quota or credit control quota is insufficient. Purchase a new package or contact the corresponding CBM to apply for a credit control quota.
DATA_NOT_EXIST The error message returned because the queried SMS message record does not exist. Try again later.
RAM_PERMISSION_DENY RAM verification failed due to insufficient user permissions. Authorize all permissions of the RAM calling interface and try again.
FORBIDDEN_ACTION User interface degradation. Contact the platform to resolve the issue and restore the interface to the normal calling capability.
INVALID_SENDERID The senderId is invalid. Please contact the platform to resolve.
QUERY_DATE_ILLEGAL The specified query time is invalid. Check the parameter configurations to ensure parameter accuracy.
SYSTEM_LIMIT_CONTROL The Daily sending limit of the system is reached. Please feedback the platform to solve.
ALERT_LIMIT_DAY The user's daily sending limit is reached. On the console General Settings > Security settings Reset the total amount of days.
ALERT_LIMIT_MONTH The monthly sending limit for users is reached. On the console General Settings > Security settings Reset total hours
PRODUCT_NOT_SUBSCRIBED The Short Message Service is not activated. Activate Short Message Service in the console.
QPS_LIMIT_CONTROL The system QPS sending limit is reached. The maximum QPS for a single user has been reached. Adjust the QPS properly based on the calling situation.
ONLINE_BILLING_FAILED International SMS online billing fails or internal RT system errors occur. The international SMS online billing system is busy, please try again later.

Receipt-related error codes

Error code Error message
IN_SMS_CONTENT Inappropriate SMS content or Invalid Message Length
INVALID_NUM Invalid destination. Receiver is not a valid number
INVALID_SENDERID Invalid sender ID
OPERATOR_NOT_SUPPORT Local Operator doesn't support
PHONE_NOT_AVAILABLE Phone number or handset is not available, or handset memory capacity exceeded
PORTED_NUM Ported number
RECEIVER_BLACKLIST Receiver is black-listed, blocked by Carrier
SYSTEM_ERR System error, caused by network operator, need to submit ticket to check the specific failed reason
SP_UNKNOWN_ERR Failed message delivery,need to submit ticket to check the specific failed reason
URL_FAILURE URL blacklisted