Last Updated: Wednesday, September 19, 2018
Any request that is invalid, or has a problem, will return the appropriate HTTP Responses. The Error Response XML outlined below will be returned in the body of the reply.
HTTP Status Code
General Processing Error. '%exception%'
Processing error while handling request.
Throughput exceeded. Try again later.
User not authorized to send MT messages from Shortcode.
Invalid Request Format/content.
Request attribute '%name%' has invalid value '%value%'.
Max Limit on Destinations exceeded.
|413||1023||Message Size %length%, exceeded maximum allowed: 500KB.||False|
Resource Not Found.
Shortcode not provisioned on Carrier.
Request Media Type not Supported, Supported Media Types: '%values%'.
Premium messaging is not supported on this shortcode.
Request attribute '%name%': '%value%' could not be processed.
Company not authorized to send MT messages from Shortcode.
User not authorized to send for Company.
%mdn% is not a mobile phone number or its carrier [%spid%] is currently not supported.
|422||1032||Message text length [%length%] exceeds 160 characters.||False|
|422||1033||Alternate Delivery is not supported for multipart messages.||False|
|405||1034||Method Not Allowed.||False|
This is the list of errors that can occur during processing a request. While this list is kept up to date, the list is not exhaustive and future errors can be added.
Certain error codes indicate that a request can be retried. It is permissible and advisable that the request can be retried again later, as the error was transient in nature and may have cleared.