Common DLR Error Codes
Updated 2026-03-06
Hi, Google folks.
Here because your current messaging provider doesn't make this easy to find? TSG Global can provide a better messaging experience than your current SMS/MMS provider. Shoot us an email at sales@tsgglobal.com to learn more about how we can help and reduce your costs.
Overview
Below are some common error codes that you may encounter when requesting DLRs from TSG Global. These error codes are primarily based on the publicly available SMPP specifications located here, but may also contain some error codes specific to upstream providers and carriers. If you would like more information about a specific DLR error code, or you would like us to investigate further, please email us at: support@tsgglobal.com
Note: you must specifically request a DLR when sending a message to receive these error codes. Please see the API documentation for more details: https://docs.tsgglobal.com
Error Codes
| Hex Value | Decimal | Description | Possible Fixes |
| 0x00000000 | 0 | No Error | N/A |
| 0x000003EC | 1004 | Message delivered to handset (toll-free specific) | N/A |
| 0x000003ED | 1005 | Message Rejected (toll-free specific) | |
| 0x000003EF | 1007 | Message Failed (toll-free specific) | |
| 0x0000044F | 1103 | Source Not Authorized (toll-free specific) | |
| 0x0000045C | 1116 | Destination Address is not text enabled (toll-free specific) | |
| 0x000004B6 | 1206 | Invalid destination address (toll-free specific) | |
| 0x000004CE | 1230 | ESME Receiver reject message error (toll-free specific) | |
| 0x00000456 | 1110 | User Opted Out (STOP) | |
| 0x00000488 | 1160 | Toll-free Not Verified | TFN must submit for Verified Sender status. Complete the Verified Sender form located in the Customer Portal. |
| 0x00000480 | 1152 | SPAM Reject | |
| 0x00000001 | 1 | Routing Failure | Max 140 octets; 160 chars in uncompressed default character encoding. |
| 0x00000002 | 2 | Undelivered - invalid destination | |
| 0x00000003 | 3 | Invalid Command ID | |
| 0x00000004 | 4 | Blocked by Carrier | |
| 0x00000005 | 5 | Blocked - SPAM | |
| 0x00000006 | 6 | Invalid Priority Flag | |
| 0x00000007 | 7 | Invalid Registered Delivery Flag | |
| 0x00000008 | 8 | System Error | |
| 0x00000009 | 9 | Reserved | |
| 0x0000000A | 10 | Invalid Source Address | |
| 0x0000000B | 11 | Invalid Dest Addr | Invalid length; the length was greater than 3 && less than 17, invalid international format. |
| 0x0000000C | 12 | Message ID is invalid | |
| 0x0000000D | 13 | Bind Failed | |
| 0x0000000E | 14 | Invalid Password | |
| 0x0000000F | 15 | Invalid System ID | |
| 0x00000010 | 16 | Short Code - Undelivered - invalid source address | Email support@tsgglobal.com and ensure you are sending using an approved short code. |
| 0x00000011 | 17 | Cancel SM Failed / Short Code - Invalid Destination Address) | |
| 0x00000012 | 18 | Reserved | |
| 0x00000013 | 19 | Replace SM Failed | |
| 0x00000014 | 20 | Message Queue Full | |
| 0x00000015 | 21 | Invalid Service Type | Set to NULL |
| 0x00000016 | 22 | Reserved thru -0x00000032 | |
| 0x00000033 | 51 | Invalid number of destinations | |
| 0x00000034 | 52 | Invalid Distribution List name | |
| 0x00000035 | 53 | Reserved thru -0x0000003F | |
| 0x00000040 | 64 | Destination flag is invalid (submit_multi) | |
| 0x00000041 | 65 | Reserved | |
| 0x00000042 | 66 | Invalid submit with replace request; submit_sm with replace_if_present_flag set | |
| 0x00000043 | 67 | Invalid esm_class field data | |
| 0x00000044 | 68 | Cannot Submit to Distribution List | |
| 0x00000504 | 1284 | Blocked Sender | Blocked for non-registration - provision a 10DLC campaign. Email support@tsgglobal.com if you need further assistance. |
| 0x00000045 | 69 | Blocked Sender | Likely reported as spam, or blocked for non-registration - provision a 10DLC campaign. Email support@tsgglobal.com if you need further assistance. |
| 0x00000503 | 1283 | Blocked Sender | Blocked for non-registration - provision a 10DLC campaign. Email support@tsgglobal.com if you need further assistance. |
| 0x00000046 | 70 | Reserved thru -0x00000047 | |
| 0x00000048 | 72 | Invalid Source address TON | Accepts International, Network, or Alphanumeric; values of 0x01, 0x03, and 0x05. |
| 0x00000049 | 73 | Invalid Source address NPI | Set to null for default value or 0x01 for ISDN numbering plan indicator. |
| 0x00000050 | 80 | Invalid Destination address TON | Accepts either Unknown Or International; values: 0x00 and 0x01. |
| 0x00000051 | 81 | Invalid Destination address NPI | Accepts either Unknown Or ISDN E163/E164: values: 0x00 and 0x01. |
| 0x00000052 | Reserved | ||
| 0x00000053 | 83 | Invalid system_type field | |
| 0x00000054 | 84 | Invalid replace_if_present flag. | |
| 0x00000055 | 85 | Invalid number of messages | |
| 0x00000056 | Reserved thru -0x00000057 | ||
| 0x00000058 | 88 | Throttling error; ESME has exceeded allowed message limits. | |
| 0x00000059 | 89 | Reserved thru -0x00000060 | |
| 0x0000093 (pending confirmation) | 93 | Number not registered - no 10DLC campaign or other authorized campaign. | Ensure that you have provisioned the number to an APPROVED 10DLC campaign. Contact support@tsgglobal.com with questions. |
| 0x00000061 | 97 | Invalid Scheduled Delivery Time | |
| 0x00000062 | 98 | Invalid message validity period (Expiry time). | |
| 0x00000063 | 99 | Predefined Message Invalid or Not Found | Your outbound messages do not match the sample messages provided to us. Please contact support@tsgglobal.com to have your sample messages updated and approved. |
| 0x00000064 | 100 | ESME Receiver Temporary App Error Code | |
| 0x00000065 | 101 | ESME Receiver Permanent App Error Code | |
| 0x00000066 | 102 | ESME Receiver Reject Message Error Code | |
| 0x00000067 | 103 | query_sm request failed | |
0x00000068 |
104 | AT&T: spam message detected/rejected | |
| 0x00000069 | 105 | AT&T: sending limit reached | Send messages at a slower rate to AT&T subscribers. You can use the TSG LRN/LERG API to determine the destination carrier. |
| 0x0000006A | 106 | AT&T: message has invalid tagging data | |
| 0x0000006B | 107 | AT&T: non-compliant URL or other non-compliance issue | |
| 0x000000C0 | 192 | Error in the optional part of the PDU Body | |
| 0x000000C1 | 193 | Optional Parameter not allowed | |
| 0x000000C2 | 194 | Invalid Parameter Length | |
| 0x000000C3 | 195 | Expected Optional Parameter missing. | |
| 0x000000C4 | 196 | Invalid Optional Parameter Value | This error occurs when an optional value parameter retrieve fails; this not normal behavior. |
| 0x000000FE | 245 | Delivery Failure, used for data_sm_resp | |
| 0x000000FF | 255 | Unknown Error | |
| 0x00000100 | Reserved for SMPP extension thru -0x000003FF | ||
| 503 | Invalid route - may not be registered for 10DLC, or a temporary network issue. | Ensure that you have provisioned the number to an APPROVED 10DLC campaign. Contact support@tsgglobal.com if you continue to see this error. | |
0x0000265D |
9821 |
T-Mobile: Tagging Error | |
0x00002655 |
9813 |
T-Mobile: Unexpected Network or System error | |
0x0000265B |
9819 |
T-Mobile: Other internal error | |
0x00002649 |
9801 |
T-Mobile: Content provider service quota has been exhausted | You've hit your daily sending quota to T-Mobile numbers. Send messages at a slower rate to all T-Mobile/Sprint/Metro PCS/etc. subscribers via your 10DLC brand/EIN. You can use the TSG LRN/LERG API to determine the destination carrier. Please see the 10DLC throughput article for more information. |
0x0000264A |
9802 |
T-Mobile: ECE quota API return error code | |
0x00002667 |
9831 |
T-Mobile: Short code verification error comparation fail with ENUM server response | |
0x00002668 |
9832 |
T-Mobile: ENUM server connection error | |
0x00002669 |
9833 |
T-Mobile: Init ENUM server error, e.g. ENUM server IP address configuration error. | |
0x00002653 |
9811 |
T-Mobile: Unexpected network or system error | Try again at a later time. |
0x00002654 |
9812 |
10DLC: number not provisioned correctly to the 10DLC ecosystem | Contact: support@tsgglobal.com |