I am receiving an error code instead of a success code, what causes this?
To help you track down the error you might be experiencing, here is a list of all the response codes the server may give you and their meanings.
| Error Code |
Description |
Solution |
-10 |
This means an invalid username or password. |
Check your username and password are correct (they are both case sensitive). |
-15 |
This means invalid destination or destination not set up on your account. |
Check to ensure your destination number is in International format and the country you are sending to is enabled on your account (contact your account manager for adding new destinations to your account). This can also occur if there are no routes currently available to deliver your message. |
-5 |
Not enough credit. The message(s) you are trying to send cost more than the remaining balance of your account. Please note concatenated messages are charged for each part of the message. |
You can increase the balance of your account by making a payment. |
-20 |
System error |
This means there was a temporary issue and resubmitting the message in 1 or 2 minutes will likely solve the matter. Please note it is possible (although unlikely) that if you were sending a message to multiple destinations that some may have been successful and therefore incurred a charge. |
-25 |
Request error. This means there was something wrong with the message you were trying to send- either that a needed parameter was missing or one of the parameters was incorrect. |
Check your parameters before trying again. |
Required parameters are:
- S=H
- UN (username)
- P (password)
- DA (delivery address)
- SA (source address)
- M (message)
- ST (source address TON)
ST is required to ensure that the originator is displayed correctly on the receiving handset. For more information, please see our article on
International Number Formatting.
For a full list of parameters please consult the
HTTP SMS Specification Document article.