This topic describes the latest error codes and return error codes.

Note To improve our SMS service, we will be updating our APIs and the corresponding error codes on 13 August 2020. Of which, we have included a new "Expired" status code "6" in the DLR report. Please take note and update your systems if necessary.

Common error codes

API error code Description Solution
OK Success. -
SYSTEM_ERROR System Error. Please contact Alibaba Cloud SMS to resolve the issue
NOT_SUPPORTED_COUNTRY Alibaba Cloud SMS is not supported in this country. Please contact Alibaba Cloud SMS to resolve the issue
OUT_OF_SERVICE Alibaba Cloud SMS service is out of service. Please contact your account manager to resume services
ACCOUNT_NOT_EXISTS The SMS account information does not exists. Please check if you had enabled SMS service
SMS_CONTENT_CODE_ILLEGAL The SMS message content is not allowed. Please ensure the message do not contain any spam related content
SMS_SIGN_NAME_ILLEGAL The SMS message signature is not allowed. Please ensure the SMS signature is within the guidelines as stated on our web site
MOBILE_NUMBER_ILLEGAL The mobile number format is invalid. Please resubmit the message with a valid mobile number format
MOBILE_COUNT_OVER_LIMIT The number of mobile numbers exceeded 1000 per batch. Please limit the number of mobile numbers to 1000 when the batch API.
CONTENT_MISSING_PARAMETERS Some parameters are missing. Please ensure that all parameters are included in the requests.
INVALID_PARAMETERS Invalid parameters. Please ensure submitted parameters are in the valid format.
INVALID_JSON_PARAM The JSON paramter is empty; or JSON string parsing error. Please ensure submitted parameters are in the valid format.
BLACK_KEY_CONTROL_LIMIT There are spam related content within the message. Please ensure the message do not contain any spam related content.
PARAM_LENGTH_LIMIT You have reached the parameter length limit. Please contact Alibaba Cloud SMS to resolve the issue
AMOUNT_NOT_ENOUGH The package credit has been fully consumed. Please purchase a new package to continue sending SMS.
DATA_NOT_EXIST There are no records for the SMS. Please try again later.
RAM_PERMISSION_DENY Access denied for RAM account. Please grant access rights to necessary RAM accounts and retry again.
FORBIDDEN_ACTION Access to account has been forbidden Please contact Alibaba Cloud SMS to resume services.
INVALID_SENDERID This is an invalid SenderID Please contact Alibaba Cloud SMS to resolve the issue
QUERY_DATE_ILLEGAL The date of query is invalid. Please ensure submitted parameters are in the valid format.
SYSTEM_LIMIT_CONTROL System sending limit has been reached. Please contact Alibaba Cloud SMS to resolve the issue
ALERT_LIMIT_DAY Account daily sending limit has been reached. Please re-configure the daily sending limit in the console.
ALERT_LIMIT_MONTH Account monthly sending limit has been reached. Please re-configure the monthly sending limit in the console.
PRODUCT_NOT_SUBSCRIBED SMS service is not activated Please enable the SMS service in the console..

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
UNKNOWN_ERR Failed message delivery,need to submit ticket to check the specific failed reason
URL_FAILURE URL blacklisted