SMPP Error Codes
Below is the complete list of SMPP error codes returned by the gateway. This table includes hexadecimal codes, decimal codes, and their meanings to help developers troubleshoot integration and message delivery issues.
| Error Code (Hex) | Error Code (Decimal) | Description |
|---|---|---|
| 0x00 | 0 | Command executed successfully |
| 0x01 | 1 | Message Length is invalid |
| 0x02 | 2 | Command Length is invalid |
| 0x03 | 3 | Invalid Command ID |
| 0x04 | 4 | Incorrect BIND Status for given command |
| 0x05 | 5 | ESME Already in Bound State |
| 0x06 | 6 | Invalid Priority Flag |
| 0x07 | 7 | Invalid Registered Delivery Flag |
| 0x08 | 8 | System Error |
| 0x0A | 10 | Invalid Source Address |
| 0x0B | 11 | Invalid Destination Address |
| 0x0C | 12 | Message ID is invalid |
| 0x0D | 13 | Bind Failed |
| 0x0E | 14 | Invalid Password |
| 0x0F | 15 | Invalid System ID |
| 0x11 | 17 | Cancel SM Failed |
| 0x13 | 19 | Replace SM Failed |
| 0x15 | 21 | Invalid Service Type |
| 0x33 | 51 | Invalid number of destinations |
| 0x34 | 52 | Invalid Distribution List name |
| 0x40 | 64 | Destination flag is invalid (submit_multi) |
| 0x42 | 66 | Submit w/replace functionality has been requested where it is either unsupported or inappropriate for the particular MC |
| 0x43 | 67 | Invalid esm_class field data |
| 0x44 | 68 | Cannot Submit to Distribution List |
| 0x45 | 69 | submit_sm, data_sm or submit_multi failed |
| 0x48 | 72 | Invalid Source address TON |
| 0x49 | 73 | Invalid Source address NPI |
| 0x51 | 81 | Invalid Destination address NPI |
| 0x53 | 83 | Invalid system_type field |
| 0x54 | 84 | Invalid replace_if_present flag |
| 0x55 | 85 | Invalid number of messages |
| 0x58 | 88 | Throttling error (ESME has exceeded allowed message limits) |
| 0x61 | 97 | Invalid Scheduled Delivery Time |
| 0x62 | 98 | Invalid message validity period (Expiry time) |
| 0x63 | 99 | Predefined Message ID is Invalid or specified predefined message was not found |
| 0x65 | 101 | ESME Receiver Permanent App Error Code |
| 0x66 | 102 | ESME Receiver Reject Message Error Code |
| 0x67 | 103 | Query_Sm request failed |
| 0xC0 | 192 | Error in the optional part of the PDU Body |
| 0xC1 | 193 | TLV not allowed |
| 0xC2 | 194 | Invalid Parameter Length |
| 0xC3 | 195 | Expected TLV missing |
| 0xC4 | 196 | Invalid TLV Value |
| 0xFE | 254 | Transaction Delivery Failure |
| 0xFF | 255 | Unknown Error |
| 0x100 | 256 | ESME Not authorised to use specified service_type |
| 0x101 | 257 | ESME Prohibited from using specified operation |
| 0x102 | 258 | Specified service_type is unavailable |
| 0x103 | 259 | Specified service_type is denied |
| 0x105 | 261 | Source Address Sub unit is Invalid |
| 0x106 | 262 | Destination Address Sub unit is Invalid |
| 0x107 | 263 | Broadcast Frequency Interval is invalid |
| 0x108 | 264 | Broadcast Alias Name is invalid |
| 0x109 | 265 | Broadcast Area Format is invalid |
| 0x10A | 266 | Number of Broadcast Areas is invalid |
| 0x10B | 267 | Broadcast Content Type is invalid |
| 0x10C | 268 | Broadcast Message Class is invalid |
| 0x10D | 269 | Broadcast_sm operation failed |
| 0x10F | 271 | Cancel_broadcast_sm operation failed |
| 0x110 | 272 | Number of Repeated Broadcasts is invalid |
| 0x111 | 273 | Broadcast Service Group is invalid |
| 0x112 | 274 | Broadcast Channel Indicator is invalid |
| 0x15F95 | 90005 | Local Exception. Check LastException property |
| 0x400 | 1024 | User Account Locked Or Inactive |
| 0x401 | 1025 | Insufficient credit |
| 0x402 | 1026 | Template Missmatch |
| 0x404 | 1028 | Invalid Ip |
| 0x405 | 1029 | Invalid Sender ID |
| 0x40C | 1036 | Queue server error |
| 0x40D | 1037 | Cache server error |
| 0x40E | 1038 | Invalid connection state |
| 0x40F | 1039 | Smpp timeout |
| 0x410 | 1040 | Unknown SMPP error |
| 0x321 | 801 | Country Undef |
| 0x322 | 802 | Invalid country |
| 0x323 | 803 | Price undef |
| 0x324 | 804 | Expired |
| 0x325 | 805 | Route undef |
| 0x43E | 1086 | SMPP Gateway Unavailable |