Error codes
Errors can occur when interacting with the Reach platform. In any case, the ouput of your request would contain the appropriate errorCode and errorMessage that best describe the encountered issue, if any.
The error codes defined by the Messaging API are summarized in the table below:
| Error code | Error description |
|---|---|
| 400 | Bad Request |
| 403 | Request Forbidden |
| 404 | Resource Not Found |
| 429 | Too Many Requests |
| 503 | Internal Error |
| 10002 | Missing Request Data |
| 10003 | Accept Media Type Error - Requests should have 'Accept' Header set to 'application/json' |
| 20002 | Authentication Error - Missing Request Authentication Headers |
| 20003 | Authentication Error - Bad Credentials |
| 20004 | Authentication Error - Multiple Users Associated to Credentials |
| 20005 | Authentication Error - The requested applet is deactivated and can't be modified |
| 20006 | Invalid page size. It cannot be zero or negative. |
| 20007 | Invalid page number. It cannot be zero or negative. |
| 20101 | Invalid destination phone number or you are trying to send a message from a phone number to itself |
| 20102 | Invalid source phone number or you are using a sender Id that is not registered in your account |
| 20103 | Invalid body data. The data should not be blank, empty and should not exceed 1600 characters in length |
| 20104 | Invalid scheduled time. A message must be scheduled at least 15 min in advance of message send time and cannot be scheduled more than 7 days in advance. |
| 20105 | Invalid validity period. Either a negative value is provided or the maximum authorized value has been exceeded. |
| 20106 | Invalid statusCallback URL. The provided string is not a valid URL. |
| 20107 | Invalid data encoding schema. The provided body message could not be encoded as GSM7 or UCS2. |
| 20108 | Invalid body data. The number of segments for a given message should not exceed 10. |
| 20109 | Invalid maximum price. It cannot be zero or negative. |
| 20201 | Unsatisfied price condition. The cost of the message exceeds the maximum price specified. |
| 20202 | Unsatisfied price condition. Insufficient balance. Please consider top-up the applet wallet. |
| 20203 | Too many requests - Send rate exceeded. |
| 20208 | Too many requests. |
| 20209 | Timeout exceeded. |
| 20210 | Internal server error. |
| 20301 | Internal Server Error - Error occuring while sending the message. |
| 20302 | Internal Server Error - Error occuring while generating the Id of the message. |
| 20404 | The requested resource was not found. |
| 20405 | The method is not allowed on the requested resource since it was not previously scheduled. |
| 20406 | The scheduled resource is not in a cancelable state. |
| 20407 | The resource is not in a deletable state. |
| 30201 | Validity period expiration |
| 30202 | Maxprice check failure |
| 30203 | Insufficient funds |
| 30204 | Internal delivery error |
| 30205 | Internal unset delivery mechanism |
| 30206 | Internal unset transaction handler mechanism |
| 30207 | Message canceled |
| 30208 | Max submission retry number reached |
| 30209 | Max session retry number reached |
| 30210 | Incorrect message |
| 30211 | Unknown datacoding |
| 30212 | Unavailable requested service |
| 30213 | Unknown error |