This topic describes the up-to-date error codes and receipt codes of Short Message Service (SMS).

Note To improve user experience, SMS updated the API-related and vendor-related error codes on August 13, 2020. The expired status is added to the delivery status report with a status code of 6. You can determine whether to update your system based on business requirements.

Common error codes

Error code Description Solution
OK No error occurred. -
SYSTEM_ERROR A system error occurred. Contact SMS technical support for help.
NOT_SUPPORTED_COUNTRY SMS does not support the specified destination country. Contact SMS technical support for help.
OUT_OF_SERVICE The international SMS service is unavailable. Contact SMS technical support for help.
ACCOUNT_NOT_EXISTS The specified account does not exist. Check whether you have activated SMS or contact SMS technical support for help.
SMS_CONTENT_CODE_ILLEGAL The specified template does not exist or is blocked. Apply for a new template.
SMS_SIGN_NAME_ILLEGAL The specified signature does not exist or is blocked. Apply for a new signature.
MOBILE_NUMBER_ILLEGAL The format of the specified mobile number is invalid. Check the format of the mobile number and resubmit the mobile number to SMS.
MOBILE_COUNT_OVER_LIMIT The number of mobile numbers exceeds 1,000. Check whether the number of mobile numbers exceeds 1,000 when you call the batchAPI operation. Then, resubmit the mobile numbers to SMS.
CONTENT_MISSING_PARAMETERS The specified template variable is left empty. Specify a valid value for the variable in the template.
INVALID_PARAMETERS The input parameters are invalid. Check whether the parameters are valid.
INVALID_JSON_PARAM The parameter is left empty. The JSON string failed to be parsed. Check whether the parameters are valid.
BLACK_KEY_CONTROL_LIMIT The specified template variable includes the keyword that is blocked. Check whether the variable meets the compliance requirements. Then, resubmit the template.
PARAM_LENGTH_LIMIT The length of the specified variable exceeds the limit. Contact SMS technical support to cancel the variable length limit.
AMOUNT_NOT_ENOUGH The resource plan is unavailable or your account does not have sufficient balance. Purchase a plan or top up your balance.
DATA_NOT_EXIST The specified SMS record does not exist. Try again later.
RAM_PERMISSION_DENY The RAM user is not authorized. Grant the required permissions to the RAM user and try again.
FORBIDDEN_ACTION The API operation is forbidden. Contact SMS technical support to enable the operation.
INVALID_SENDERID The sender ID is invalid. Contact SMS technical support for help.
QUERY_DATE_ILLEGAL The query time is invalid. Check whether the parameters are valid.
SYSTEM_LIMIT_CONTROL The daily quota of messages that SMS can send has been reached. Contact SMS technical support for help.
ALERT_LIMIT_DAY The daily quota of messages that the user can send has been reached. Log on to the console and choose System Settings > General Settings > Security Settings to set a daily quota.
ALERT_LIMIT_MONTH The monthly quota of messages that the user can send has been reached. Log on to the console and choose System Settings > General Settings > Security Settings to set a monthly quota.
PRODUCT_NOT_SUBSCRIBED SMS is not activated. Activate SMS in the console.
QPS_LIMIT_CONTROL The QPS limit is reached. Modify the QPS limit based on your business requirements.
ONLINE_BILLING_FAILED The online billing of the international SMS service failed or an internal error occurred. The international SMS online billing system is busy. Try again later.
CONTENT_EXCEED_LIMIT The number of characters in the content has exceeded the maximum value. Reduce the number of characters in the content. The content size cannot exceed 512 KB.
QUANTITY_INCONSISTENT The number of destination mobile numbers that are indicated by the To field is inconsistent with the number of text messages that are indicated by the Message field. Make sure that the number of destination mobile numbers and the number of text messages are consistent.

Receipt-related error codes

Error code Error message
success success
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