Troubleshooting errors: SMS API
When an error occurs, an error code and message are generated in the returned result, in XML format:
<statusResponse>
<status>error</description>
<description>An error occurred</description>
</statusResponse>
The following table can help you diagnose the error:
| Error Code and Message | Reason for error |
|---|---|
| ERROR 502 – Index is not currently a supported method of this API. | Index request not supported. |
| ERROR 503 – PUT is not currently a supported method of this API. | PUT, GET and INDEX requests are not supported for the SMS API. |
|
ERROR 510 – API Requests from this IP Address (<IPAddress>) are not allowed. where <IPAddress> is the denied IP address |
The device used does not exist on the Server IP Allowlist. For more information, see SMS API introduction. |
| ERROR 511 – <Parameter> is required. | Missing mandatory parameter. |
| ERROR 519 – Unknown parameter: <Parameter> | Unknown parameter supplied. |
|
ERROR 520 – Mode '<value>' is not valid where <value> is the supplied value |
The mode parameter is empty, or contains one or more invalid mode specifiers. |
| ERROR 521 – Mode not specified | The mode parameter is empty, or contains one or more invalid mode specifiers. |
|
ERROR 525 – Max message length of X chars exceeded where X is the limit for the specified mode |
The SMS message is too long. Messages are limited to:
|
| ERROR 526 – message_id must be supplied for delivery receipt | Only applies when a delivery receipt is requested. The message_id is missing. |
| ERROR 530 – API Requests authentication failed. |
The |
| ERROR 533 – Invalid receipt_url value supplied | The delivery receipt URL supplied is incorrect, invalid, or missing. |
| ERROR 535 – Invalid message_id value supplied | The message_id value is missing. |
| ERROR 536 – Invalid text value supplied | The Text value is missing. |
|
ERROR 555 – Invalid MSISDN (<MSISDN>) supplied where <MSISDN> is the invalid Mobile Station International ISDN Number (MSISDN) |
The supplied MSISDN is incorrect. Ensure you include the appropriate country calling code. |
| ERROR 555 – Invalid Input Provided | The Query Parameters are incorrect, missing, or invalid. |
|
*ERROR 630 – Invalid MSISDN (<MSISDN>) supplied where <MSISDN> is the invalid Mobile Station International ISDN Number (MSISDN) |
The supplied MSISDN is incorrect. Ensure you include the appropriate country calling code. |
|
ERROR 570 –Destination MSISDN (<MSISDN>) has no credit where <MSISDN> is the destination MSISDN |
Only applies where the destination MSISDN account is charged. You must add credit to the destination MSISDN before you can use the SMS API with that MSISDN. For information about adding credit to your account, see Making a payment. |
| ERROR 580 – Please use only GSM 03.38 basic 7 bit characters, or specify 8 bit mode | A non-standard character exists in the message text. For 7-bit mode, SMS API only supports characters from the ETSI USSD default alphabet, as defined in GSM 03.38. |
