Error Codes

SMS error codes can be used to identify the reason for message delivery failures.

List of Error Codes

Error Reason Description
10Invalid messageThe system runs basic validations on the message content when sending a message, however, some messages may still be rejected by mobile carriers. This error code indicates that the message was rejected by the carriers with the reason “invalid message”. Please contact support if you encounter this error frequently.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
20Network ErrorThe mobile carrier delivering the text message had network issues. This is a temporary error. You can retry at a later time when the mobile carrier network is unaffected.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
30Spam DetectedOne of the most common reasons for SMS delivery failure is mobile carrier level spam filters. Mobile carriers have added systems that detect spam content and then block them from being delivered. Unfortunately, these filters are always hidden, subject to carrier preferences, vary from carrier to carrier, and can be changed without notice.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
40Invalid Source NumberThe source number you entered is either not in the correct format, not SMS-enabled or not assigned to your Plivo account. Check the phone number and ensure that it is in the correct format and has the ability to send text messages.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
50Invalid Destination NumberThe number you entered is either not entered correctly, not SMS-enabled or is a landline. Check the phone number to ensure that it is able to receive text messages.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
60Loop DetectedThe mobile carrier is not able to route your SMS because of an endless loop of messages being sent and received between the system and the phone number. This can occur when two auto-responding SMS applications start to talk to each other and end up in a loop. In some cases, this error code is returned when the carrier determines that it is impossible to route the SMS and the message has to be dropped as it is being looped between platforms.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
70Destination Permanently UnavailableThe phone number is not active and there is no indication of when it will become available again. Note that this is a broad error code where the carrier has not indicated the reason for the destination unavailability. Check the phone number to ensure that it is correct.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
80Destination Temporarily UnavailableThe phone number is not reachable. Note that this is a broad error code and often times, the carrier does not indicate the reason for the destination to be temporarily unavailable. Though, possible reasons could be due to the handset being turned off or out of coverage. To resolve this, retry your messages at a later time.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
90No route availableThe mobile carrier and fallback carriers were not able to deliver the SMS message because the route was not available. Please note that carriers do not offer the reason for why the route is unavailable, but since this is typically a carrier issue, please contact support.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
100Prohibited by CarrierThe mobile carrier rejected the text message because the network did not support the message being sent. This could occur if the destination network does not support SMS.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
110Message too longThe message content exceeds the character limit of 1600 for GSM and 737 for UTF encoded messages.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
200Source number blocked by STOP from destination numberThe phone number has opted out and blocked all messages sent from your phone number. Opt-outs are typically received via text message replies with a opt-out keyword including “STOP”. All messages to destinations that have opted out will be blocked until the destination opts in with a response of “START”
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
300Failed to dispatch MessageAn error was encountered while passing on the message to the mobile carrier. This is an internal failure, and messages with this error code can be retried at a later time. Please contact support if you’re seeing this error consistently.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
420Message ExpiredMessages that remain in the processing queues for longer than 16 hours are not forwarded to the mobile carrier. If you are consistently receiving this error , please contact support.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
450Destination Country DisabledMessages to this Destination country are not available.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
900Insufficient CreditPlease contact support with this error code
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
910Account DisabledPlease contact support with this error code
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
1000Unknown ErrorDelivering your message failed for reasons that are unknown to us and to the mobile carriers. If you notice too many of these cases, please contact support.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
2XXXHTTP Error Received From Message URL For Incoming SMSThe XXX part of the error code represents the HTTP error response received from the message_url for an undelivered incoming SMS. Please contact support with this error code.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
120MMS Message Payload Too LargeThe total size of the MMS (text + media) exceeds the 5MB limit. Messages exceeding the 5MB limit are not submitted to mobile carriers. Please adjust the size of your message.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
130Unsupported Message MediaOne or more of the attached MMS media is of an unsupported type. Messages containing unsupported media are not submitted to the mobile carriers. Please adjust your message to include the proper media type.
——————— ——————— ——————— —————————————————————————————————————————————————————————————————————————————————————————-
140Message Media Processing FailedThe specified media attachments could not be processed. This may happen if the media URL specified is unreachable, or file data is incorrectly formatted.