Menu

Nexmo SMS Delivery Error Codes

All Delivery Receipts with a non-zero error code can be considered as indicating failed delivery. i.e. Your SMS did not reach the recipient.

Neither Nexmo SMS APIs nor operators will perform further attempts to re-deliver a message unless another API call is performed.

Nexmo error codes:

The err-code field in the DLR provides more detailed information and can help troubleshoot a failed delivery. A non-zero code indicates that the message could not be delivered.

err-code Meaning Description
0 Delivered Message was delivered successfully
1 Unknown Message was not delivered, and no reason could be determined
2 Absent Subscriber - Temporary Message was not delivered because handset was temporarily unavailable - retry
3 Absent Subscriber - Permanent The number is no longer active and should be removed from your database
4 Call Barred by User This is a permanent error:the number should be removed from your database and the user must contact their network operator to remove the bar
5 Portability Error There is an issue relating to portability of the number and you should contact the network operator to resolve it
6 Anti-Spam Rejection The message has been blocked by a carrier's anti-spam filter
7 Handset Busy The handset was not available at the time the message was sent - retry
8 Network Error The message failed due to a network error - retry
9 Illegal Number The user has specifically requested not to receive messages from a specific service
10 Illegal Message There is an error in a message parameter, e.g. wrong encoding flag
11 Unroutable Vonage cannot find a suitable route to deliver the message - contact support@nexmo.com
12 Destination Unreachable A route to the number cannot be found - confirm the recipient's number
13 Subscriber Age Restriction The target cannot receive your message due to their age
14 Number Blocked by Carrier The recipient should ask their carrier to enable SMS on their plan
15 Prepaid Insufficient Funds The recipient is on a prepaid plan and does not have enough credit to receive your message
50 Entity Filter The message failed due to entity-id being incorrect or not provided. More information on country specific regulations
51 Header Filter The message failed because the header ID (from phone number) was incorrect or missing. More information on country specific regulations
52 Content Filter The message failed due to content-id being incorrect or not provided. More information on country specific regulations
53 Consent Filter The message failed due to consent not being authorized. More information on country specific regulations
54 Regulation Error Unexpected regulation error - contact support@nexmo.com
99 General Error Typically refers to an error in the route - contact support@nexmo.com

For further information see: Why was my SMS not delivered?

 

Was this article helpful?
4 out of 9 found this helpful
Follow
Have more questions? Submit a request