SMS Gateway returns specific error codes to help identify and resolve issues with message delivery. This reference provides detailed information about each error code and recommended solutions.
| Error Code | Error Type | Description |
|---|---|---|
| 8 | Wrong destination number | The destination number is invalid or cannot receive SMS |
| 56 | Invalid number format | The destination number format is malformed |
| 59 | Invalid reference service | The provided reference service is not recognized |
| 60 | Anti-flooding block | Message blocked by anti-flooding protection |
| 61 | Watchlist block | Message blocked by watchlist rules |
| 63 | Authentication error | Missing or invalid credentials |
| 64 | Provider unavailable | SMS provider is temporarily unavailable |
| 66 | Empty message text | Message text is empty or missing |
| 74 | URL not allowed | Message containing URL is denied |
The destination number is invalid or cannot receive SMS messages. This error occurs when the number exists but cannot accept SMS delivery. It indicates a permanent failure. Retrying will produce the same error.
{
"code": 8,
"message": "Wrong number",
"details" : null
}- Number is not active or has been disconnected
- Number belongs to a landline that cannot receive SMS
- Number is in a country or network that blocks SMS
- Number has opted out of receiving SMS messages
- Verify the destination number is correct and active
- Confirm the number belongs to a mobile device
The destination number format is malformed or does not conform to international numbering standards.
{
"code": 56,
"message": "Invalid number",
"details" : null
}- Missing country code prefix
- Extra characters (spaces, dashes, parentheses)
- Incorrect number of digits
- Invalid country code
- Double plus signs or other formatting errors
- Use international format with country code: +[country code][number]
- Remove all spaces, dashes, and special characters
- Verify the country code is correct
- Ensure the number has the correct length for the destination country
The provided reference service value is not recognized by SMS Gateway. Reference services must be from the predefined list of allowed values.
{
"code": 59,
"message": "Invalid reference service",
"details" : null
}- Using a custom service name not in the allowed list
- Typo in the service name
- Case sensitivity mismatch
- Check the Reference Attribute Documentation for allowed service values
- Verify the service name spelling and case
- Omit the reference parameter if not needed
- Contact support to register a new service name if required
The message was blocked by the anti-flooding protection system. This system enforces a rate limit per destination phone number: if too many messages are sent to the same number within a short time window, subsequent messages are blocked. This is a permanent failure for that specific send attempt — the message will not be delivered.
For details on how the anti-flooding system works, see Anti-flooding.
Reduce the frequency of messages sent to the same destination number. Wait before retrying.
The message was blocked because the destination number, LRA, or country combination exists in the watchlist. Watchlist entries are used to block specific patterns or destinations.
{
"code": 61,
"message": "Watchlist error",
"details" : null
}- Destination number is on the account watchlist
- Number has been flagged for abuse or fraud
- Country or prefix is blocked for your account
- The destination number is blocked by watchlist rules. It is not possible to send SMS to this number. If you believe this is an error, contact Namirial support.
The request is missing authentication credentials or the provided credentials are invalid.
{
"code": 63,
"message": "Missing basic authentication header",
"details": null
}- Include the
Authorization: Basic base64(username:password)header in every request. - Verify that username and password are correct and the account is active.
- See Authentication for setup instructions.
The SMS provider for the destination country is temporarily unavailable. This is typically a transient error that resolves automatically. The SMS Gateway implements automatic retry logic, and this issue occurs only if all the providers are not available.
{
"code": 64,
"message": "Provider unavailable",
"details" : null
}- Temporary provider outage or maintenance
- Network connectivity issues
- Provider service degradation
- Implement retry logic
- Check Namirial status page for known issues
- Contact support if the issue persists
The message text is empty or missing. This is a permanent failure — the message will not be sent.
{
"code": 66,
"message": "Empty or missing message text",
"details": null
}- Ensure the
textfield is present and not empty in the request body.
The message contains a URL and the account is not enabled to send this type of content. This is a permanent failure — retrying will produce the same error.
- Contact support to configure the account to send URLs
Contact Namirial support with the complete error response, including error code, message, and request details. Include the message ID if available.