Messaging Failure Reasons
As messages get sent on to the carriers, there are cases where they will return a FAILED message status. Carriers are now consistently providing more detailed failure reasons in conjunction with the failed message status. As a result, we have updated our platform to capture these reasons in plain language and store them. This allows us to surface the failure reasons (when provided) in our Account & Line Detail reports alongside the message status.
NOTE: Not every single failed message may have a detailed failure reason.
| Failure Reason Code | Summary |
|---|---|
| 1 - CarrierException | The carrier provided a generic error code. |
| 2 - MalformedSource | The source number is incorrectly formatted. |
| 3 - InvalidSource | The source number does not exist (in the carrier), etc. |
| 4 - MalformedDestination | The destination number is incorrectly formatted. |
| 5 - InvalidDestination | The destination number does not exist, does not have SMS, etc. |
| 6 - CarrierOptOut | The recipient is opted out from the carrier or service provider. |
| 7 - CarrierRejected | The carrier or service provider rejected the message but provided no specific reason. For AT&T traffic, this could be a prepaid user whose account is out of money, a subscriber that is provisioned to not receive this type of SMS or it was identified as Spam. |
| 8 - CarrierTimeout | The carrier timed out waiting for the delivery receipt, this could be because the downstream provider did not send the requested delivery receipt or they sent after the system timed out at two hours. |
| 9 - CarrierRateLimited | The carrier or service provider rate limit has been reached. Higher vetting may be required for 10dlc numbers. |
| 10 - CarrierRoutingError | Carrier is reporting there is no route available for message. This could be because no routing exists to destination, no roaming route is available, the destination handset is roaming on a network that cannot be reached, no SS7 route, or routing was denied. |
| 11 - CarrierAccountError | The carrier account has an issue, the incorrect external credentials are being used, etc. |
| 12 - FlaggedAsSpam | The carrier or service provider flagged the message as spam. |
| 13 - ForbiddenCountry | The carrier or service provider marked the destination country as forbidden. |
| 14 - ForbiddenShortCode | An invalid or non-existent short code is being used as the source. |
| 15 - MediaUnavailable | Attached media could not be found or retrieved. |
| 16 - CarrierContentSizeExceeded | Attached media or message body exceeds the carrier content size limit. |
| 17 - InvalidContentType | Attached media is an invalid content type. |
| 18 - UnknownServiceCenterAddress | The service center address is unknown. |