International error codes, SMPP message states, and their solutions-Short Message Service(SMS)-阿里云帮助中心

Covers Alibaba Cloud SMS error codes across the international SMS message lifecycle—API calls, delivery, and receipts—with solutions for each.

Error code classification

Note

Use Ctrl+F (or Command+F) to search for a specific error code.
You can view the error code and description for each message on the Messaging Records page.

Three types of error codes occur during the message lifecycle:

Common error codes: Returned in API responses (e.g., SendMessageToGlobe). Indicate request-level issues such as invalid parameters, insufficient permissions, or platform rejection.
Delivery receipt status codes: Returned via asynchronous callback or the SmsReport API after the platform accepts the message. Reflect the final carrier delivery result: succeeded, failed, or blocked.
SMPP error codes and message states: Returned when using the Short Message Peer-to-Peer (SMPP) protocol. Indicate the result of an SMPP command or the final message status per SMPP Protocol Specification V3.4.

Common error codes

Error code	Description	Solution
OK	The request was successful.	-
INVALID_SENDERID	The sender ID is invalid or unapproved.	Log on to the SMS console. In the left navigation pane, choose International SMS > Before Sending > SenderID.Check the status of the sender ID used in your request. Confirm that the sender ID status is Approved. Check if the sender ID passed in the call exactly matches the approved one, including case and spaces.
FORBIDDEN_ACTION	Your account's API call permissions have been downgraded.	Submit a ticket to restore the API call access.
OUT_OF_SERVICE	The SMS service is suspended.	-
ACCOUNT_NOT_EXISTS	The account does not exist.	Activate SMS and complete identity verification.
MOBILE_NUMBER_ILLEGAL	The mobile phone number format is incorrect.	Verify the phone number format and resubmit the request.
CONTENT_MISSING_PARAMETERS	A value is missing for a variable in the message template.	Check the `TemplateParam` parameter. Ensure that the keys in the JSON structure exactly match the variable names defined in your message template (for example, `${code}`) and that all variables have been assigned a value.
INVALID_PARAMETERS	One or more parameters are invalid.	Check your parameter configuration to ensure all values are correct.
INVALID_JSON_PARAM	A parameter is empty, or the JSON string could not be parsed.	Check your parameter configuration to ensure all values are correct.
PARAM_LENGTH_LIMIT	The length of a template variable value exceeds the limit.	Check the length of the message content after variable substitution. Confirm that the value for a single variable does not exceed 200 characters. Ensure the total message content after substitution does not exceed the platform limit.
AMOUNT_NOT_ENOUGH	Your account has an insufficient balance or resource package.	Purchase a resource plan or top up your balance.
SYSTEM_ERROR	An internal system error occurred.	A temporary error occurred on the Alibaba Cloud platform. Try again later. If the problem persists, submit a ticket and provide the RequestId.
DATA_NOT_EXIST	The queried message record does not exist.	Try again later.
QPS_LIMIT_CONTROL	The QPS limit for message sending was reached.	Reduce your API call frequency to stay within your account's QPS limit.
ONLINE_BILLING_FAILED	Online billing failed, or an internal system error occurred.	The online billing system is busy. Try again later.
QUERY_DATE_ILLEGAL	The query time range is invalid.	Check your parameter configuration to ensure all values are correct.
RAM_PERMISSION_DENY	Resource Access Management (RAM) verification failed due to insufficient permissions.	Grant the RAM user the required permissions to call the API and try again.
PRODUCT_NOT_SUBSCRIBED	SMS is not activated.	Log on to the SMS console and activate the service.
SMS_SECURITY_INTERCEPTED	The message was blocked by a risk control policy.	-
SMS_CONTENT_ILLEGAL	The message content is noncompliant.	Ensure that your message content complies with all applicable laws and regulations.
ACCOUNT_ILLEGAL	Your account has been blacklisted for sending noncompliant content.	-
BLACK_KEY_CONTROL_LIMIT	A variable in the message content contains a blacklisted keyword.	The variable's value triggered a platform security policy. Review and modify any sensitive or noncompliant content in the variable.
NOT_SUPPORTED_COUNTRY	Sending messages to this country or region is not supported.	-
SENDERID_BLACKLISTED	A risk control policy blocked the sender ID.	-
IMDA_COMPANY_REQUIRE_LOA	The sender ID must be registered with the Infocomm Media Development Authority (IMDA).	Register your sender ID with the IMDA.
SYSTEM_LIMIT_CONTROL	The daily sending limit for the system is reached.	-
FREQUENCY_LIMIT_DAY	The daily sending limit for a single number is reached.	In the console, go to System Configurations > General Settings > Message Sending Limit and reset the daily sending limit for a single number. Default limit: 40 messages per day.
ALERT_LIMIT_DAY	The daily sending limit for your account was reached.	In the console, go to System Configurations > General Settings > Message Delivery Settings > Global Configurations > Global Configuration and reset the daily limit.
ALERT_LIMIT_MONTH	The monthly sending limit for your account was reached.	In the console, go to International and Chinese Hong Kong, Macao, and Taiwan SMS > Send SMS > International Message Settings > Sending Threshold Settings > Global Configuration and reset the monthly limit.
COUNTRY_TRAFFIC_LIMIT	The daily sending limit for a specific destination country or region was reached.	In the console, go to International and Chinese Hong Kong, Macao, and Taiwan SMS > Send SMS > International Message Settings > Route Management > Route Management and reset the daily sending limit for that destination.
CONTENT_EXCEED_LIMIT	The message content exceeds the 512 KB size limit.	Reduce the message size to be within the 512 KB limit.
QUANTITY_INCONSISTENT	The number of recipients (in the `To` field) does not match the number of messages (in the `Message` field).	Ensure that the number of recipients matches the number of messages.
Specified AccessKeyId is not found	The specified AccessKeyId does not exist.	Check that the AccessKeyId configured in your code is correct, valid, and has not been disabled.
REJECTED_SENDERID_NOT_AVAILABLE	The sender ID specified in the request has not been registered on your account.	Log on to the SMS console. In the left navigation pane, choose International SMS > Before Sending > SenderID.Check whether the sender ID used in the request has been registered, and verify that the sender ID is in the "Successful" status. Check whether the sender ID passed in the API call exactly matches the approved one (case-sensitive, including spaces).
LENGTH_LIMIT	The content exceeds the length limit.	The SMS content exceeds the length limit. Please reduce it to 1,500 characters or fewer.
BILLING_DEDUCTION_ERROR	The system failed to deduct the service fee from your account.	The system failed to deduct the service fee from your account. Please try again later.

Delivery receipt status codes

Status code	Description
success	The message was sent successfully.
IN_SMS_CONTENT	The message content or length is invalid.
INVALID_NUM	The recipient's phone number is invalid.
INVALID_SENDERID	The sender ID is invalid.
OPERATOR_NOT_SUPPORT	The carrier does not support the phone number.
PHONE_NOT_AVAILABLE	The phone number or recipient device is unavailable, or the device's storage is full.
PORTED_NUM	The carrier for the phone number has changed.
RECEIVER_BLACKLIST	The recipient's number is on a carrier blacklist.
SYSTEM_ERR	A carrier system error occurred.
SP_UNKNOWN_ERR	The message delivery failed for an unknown reason.
URL_FAILURE	A URL in the message content is on a blacklist.
expired	The message could not be delivered because the recipient's device was turned off or out of service for an extended period.
NO_VALID_SUPPLIER	No IMDA-compliant carrier is available for Singapore.
DELIVERED_TO_HANDSET	The SMS has been successfully delivered to the recipient's mobile device.
REJECTED_RAM_PERMISSION_DENY	The RAM user does not have sufficient permissions to perform this operation. Contact the primary account administrator to grant the necessary permissions.
REJECTED_PREPAID_PACKAGE_EXPIRED	The prepaid package has expired. Please renew or purchase a new SMS package to continue using the service.
REJECTED_ACCOUNT_NOT_EXISTS	The mobile account does not exist or has been disabled. Please verify your number information.
UNDELIVERED_OPERATOR_REJECTED	The carrier rejected the SMS. Possible causes: incorrect number format, or the number has been suspended or deactivated. Please verify the validity of the phone number.
UNDELIVERED_NOT_DELIVERED	The SMS failed to send. This may be due to a network issue or a problem with the recipient's device. Please try again later.
UNDELIVERED_INVALID_NUMBER	The phone number is invalid or does not exist. Please check the number format and verify its validity.
SMS_FLOODING	An excessive SMS sending rate has been detected, triggering the anti-spam protection. Please reduce the sending frequency to avoid sending a large volume of messages in a short period.
REJECTED_SYSTEM_ERROR	An internal system error caused the SMS to fail. Please try again later. If the issue persists, contact technical support.
REJECTED_SENDERID_NOT_AVAILABLE	The sender ID is unavailable or has not been approved. Please check the signature configuration and ensure it has been approved and is applicable to the target country/region.
REJECTED_ROUTE_NOT_AVAILABLE	The SMS route is temporarily unavailable. This may be due to a network issue with the target carrier. Please try again later or contact technical support.
REJECTED_NOT_ENOUGH_CREDITS	Insufficient account balance to send the SMS. Please top up your account and try again.
REJECTED_MOBILE_COUNT_OVER_LIMIT	The number of SMS messages sent to a single phone number has exceeded the limit. Please reduce the frequency of messages sent to this number.
REJECTED_ILLEGAL_CONTENT	The SMS content contains prohibited or sensitive information and has been blocked by the system. Please modify the content and resubmit, ensuring it complies with local regulations.
REJECTED_FORBIDDEN_ACTION	This operation is prohibited. Please check the mobile account status or whether the device has rejected SMS messages.
REJECTED_FLOODING_CONTROL_AL	An excessive SMS sending rate has been detected, triggering the anti-spam protection mechanism. Please reduce the sending frequency to avoid sending a large volume of messages in a short period.
REJECTED_FLOODING_CONTROL	An excessive SMS sending rate has been detected, triggering the anti-spam protection mechanism. Please reduce the sending frequency to avoid sending a large volume of messages in a short period.
EXPIRED_EXPIRED	The SMS has expired and was not delivered. Please check the recipient's phone status and resend.
EXPIRED_DLR_UNKOWN	The SMS delivery status cannot be confirmed and may have expired. Please try again later.
DON'T DISTURB	The recipient is in a Do Not Disturb (DND) period. The SMS will not be sent until the DND period ends.
DELIVERED_TO_OPERATOR	The SMS has been successfully submitted to the carrier network.
DELIVERED	The SMS has been successfully delivered.

SMPP message states

SMPP message state	Final message state	Description
DELIVERED	DELIVRD	Message 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.
UNKNOWN	UNKNOWN	Message is in invalid state.
REJECTED	REJECTD	Message is in a rejected state.

These states comply with the SMPP Protocol Specification V3.4.