Errors / Rejections of Submit SMS API Request
In the event of receiving an HTTP 40x response from a submit SMS API request, the response body will contain a JSON document showing a response code and human readable error string.
{
"result_code": "100",
"result_message": "Un-parsable Request Document",
"client_reference": "...if provided during original request..."
}
Result Code List
| Result Code | Should Retry | Result Message |
|---|---|---|
| -4 | No | Unsupported Media Type |
| -3 | No | Not Acceptable |
| -2 | No | HTTP method not allowed |
| -1 | Yes | There has been an internal error! |
| 0 | No | Message successfully submitted |
| 1 | Yes | Throttled - submit rate exceeded - please re-submit |
| 2 | No | Authentication Failure |
| 99 | Yes | Timeout submitting message - aborted |
| 100 | No | Un-Parsable Request Document – The JSON request document supplied was not correctly formed. |
| 101 | No | Missing or invalid From Address |
| 102 | No | Missing or invalid DestinationAddress |
| 103 | No | Missing or invalid message_type value |
| 104 | No | Message text too long |
| 105 | No | Invalid validity period – the value supplied in the validity_period element is invalid, or there was an invalid combination of fields. |
| 106 | No | Invalid message_class value specified |
| 107 | No | Invalid message_waiting_indicator value specified |
| 108 | No | Invalid delivery receipt URL specified in delivery_receipts element |
| 110 | No | The api key you used does not have an API CHANNEL of HTTP |
| 111 | No | Non Whitelisted Destination - The destination address does not appear in your accounts permitted destinations list |
| 112 | No | You attempted to perform an action that is not enabled on your account |
| 113 | No | Blacklisted Destination - The destination address has been blacklisted |
| 114 | No | The request contained a custom_callback_url field in the delivery_receipts element that was too long, the maximum allowesd is 250 characters |
| 200 | No | Message Destination Unroutable – The message could not be delivered as there was no available route for this destination. |
| 201 | Yes | Submission Failed – Internal Error – The message submission failed due to an error in the service. This is a temporary condition. |
| 202 | No | Message Dropped due to routing rule – A routing decision for this message decided that the message should not be delivered to the network. |
| 203 | No | Message Dropped due to anti-spam rules – The anti-fraud / anti-spam engine within the service identified this message as spam and it was dropped. |
| 204 | No | Message Undeliverable – The message could not be delivered due to a network failure. |
| 404 | No | Not Found |
Note: First four result codes have Negative values
