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

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 SMPP error code Description Solution
OK 20 No error occurred. -
INVALID_SENDERID 25 The sender ID is invalid. Contact SMS technical support.
FORBIDDEN_ACTION 26 The API operation is forbidden. Contact SMS technical support to enable the operation.
OUT_OF_SERVICE 27 The international SMS service is unavailable. Contact SMS technical support.
ACCOUNT_NOT_EXISTS 29 The specified account does not exist. Check whether you have activated SMS or contact SMS technical support.
SMS_CONTENT_CODE_ILLEGAL 31 The specified template does not exist or is blocked. Apply for a new template.
SMS_SIGN_NAME_ILLEGAL 32 The specified signature does not exist or is blocked. Apply for a new signature.
MOBILE_NUMBER_ILLEGAL 33 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 34 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 35 The specified template variable is left empty. Specify a valid value for the variable in the template.
INVALID_PARAMETERS 36 The input parameters are invalid. Check whether the parameters are valid.
INVALID_JSON_PARAM 42 The parameter is left empty. The JSON string failed to be parsed. Check whether the parameters are valid.
PARAM_LENGTH_LIMIT 44 The length of the specified variable exceeds the limit. Contact SMS technical support to cancel the variable length limit.
AMOUNT_NOT_ENOUGH 45 The resource plan is unavailable or your account does not have sufficient balance. Purchase a plan or top up your balance.
SYSTEM_ERROR 46 A system error occurred. Contact SMS technical support.
DATA_NOT_EXIST - The specified SMS record does not exist. Try again later.
QPS_LIMIT_CONTROL 48 The QPS limit is reached. Raise the QPS limit based on your business requirements.
ONLINE_BILLING_FAILED 49 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.
QUERY_DATE_ILLEGAL 52 The query time is invalid. Check whether the parameters are valid.
RAM_PERMISSION_DENY 55 The RAM user is not authorized. Grant the required permissions to the RAM user and try again.
PRODUCT_NOT_SUBSCRIBED 57 SMS is not activated. Activate SMS in the console.
SMS_SECURITY_INTERCEPTED 61 The text messages are intercepted based on international message risk strategies. Contact SMS technical support.
SMS_CONTENT_ILLEGAL 62 The message content is invalid. Check whether the message content complies with the relevant laws and regulations, or contact SMS technical support.
ACCOUNT_ILLEGAL 63 Your account is blocked due to the previous illegal text messages. Contact SMS technical support.
BLACK_KEY_CONTROL_LIMIT 64 The specified template variable includes the keyword that is blocked. Check whether the variable meets the compliance requirements. Then, resubmit the template.
NOT_SUPPORTED_COUNTRY 65 SMS does not support the specified destination country. Contact SMS technical support.
SYSTEM_LIMIT_CONTROL 81 The daily quota of messages that SMS can send has been reached. Contact SMS technical support.
FREQUENCY_LIMIT_DAY 83 The daily quota of messages that can be sent to one mobile number has been reached. Log on to the console and choose System Settings > General Settings > Message-sending Frequency to set a daily quota. The maximum value is 20.
ALERT_LIMIT_DAY 84 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 85 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.
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.

Delivery Receipt message states

Message State Final Message States Description
DELIVERED DELIVRD Message is delivered to destination.
EXPIRED EXPIRED Message validity period has expired.
DELETED DELETED Message has been deleted.
UNDELIVERABLE UNDELIV Message is undeliverable.
ACCEPTED ACCEPTD Message is in accepted state (i.e. has been manually read on behalf of the subscriber by customer service)
UNKNOWN UNKNOWN Message is in invalid state.
REJECTED REJECTD Message is in a rejected state.

For more information, see SMPP Protocol Specification V3.4.

Receipt-related error codes

Error code SMPP error code Error message
success 0 success
IN_SMS_CONTENT 201 Inappropriate SMS content or Invalid Message Length
INVALID_NUM 202 Invalid destination. Receiver is not a valid number
INVALID_SENDERID 203 Invalid sender ID
OPERATOR_NOT_SUPPORT 204 Local Operator doesn't support
PHONE_NOT_AVAILABLE 205 Phone number or handset is not available, or handset memory capacity exceeded
PORTED_NUM 206 Ported number
RECEIVER_BLACKLIST 207 Receiver is black-listed, blocked by Carrier
SYSTEM_ERR 208 System error, caused by network operator, need to submit ticket to check the specific failed reason
SP_UNKNOWN_ERR 209 Failed message delivery,need to submit ticket to check the specific failed reason
URL_FAILURE 210 URL blacklisted
expired 211 The short message fails to be delivered because the cell phone of the customer has been shut down or out of service for a long time