Short Message Service:International error codes

Error code

Description

Solution

OK

The request was successful.

-

INVALID_SENDERID

The sender ID is invalid or unapproved.

1. Log on to the SMS console. In the left navigation pane, choose Go Globe > SenderID. Check the status of the sender ID used in your request.

2. Confirm that the sender ID status is Approved.

3. 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.

SMS_CONTENT_CODE_ILLEGAL

The message template is invalid, does not exist, or has been rejected.

Log on to the SMS Console. In the left navigation pane, select Go China > Templates. Check the approval status. If the status is Rejected, click Create Template.

SMS_SIGN_NAME_ILLEGAL

The signature is invalid, does not exist, or has been rejected.

Log on to the SMS console. In the left navigation pane, select Go China > Signatures. Check if the signature passed exactly matches the approved one. If the status is Rejected, review the reason and apply for a new signature.

MOBILE_NUMBER_ILLEGAL

The mobile phone number format is incorrect.

Verify the phone number format and resubmit the request.

MOBILE_COUNT_OVER_LIMIT

The number of mobile phone numbers exceeds the limit of 1,000.

The BatchSendMessageToGlobe operation supports up to 1,000 recipients per request. Split larger lists into multiple requests.

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.

1. Check the length of the message content after variable substitution.

2. Confirm that the value for a single variable does not exceed 200 characters.

3. 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: 20 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 and reset the daily limit.

ALERT_LIMIT_MONTH

The monthly sending limit for your account was reached.

In the console, go to System Configurations > General Settings > Message Delivery Settings > Global Configurations 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 System Configurations > General Settings > Message Delivery Settings > 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.

1. Log on to the SMS console. In the left navigation pane, choose Go Globe > SenderID. Check whether the sender ID used in the request has been registered, and verify that the sender ID is in the "Successful" status.

2. 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.

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 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.