SMPP error status codes
The SMPP error status codes are returned by an SMPP server (SMSC) when an SMS cannot be sent.
The SMSC will also set one of these error status codes when a command or PDU is invalid.
This list of error status codes is from the SMPP 3.4 specification.
The range from 0x00000100 to 0x000003FF (256 to 1023) is reserved for SMPP extensions.
The range from 0x00000400 to 0x000004FF (1023 to 1279) is reserved for SMSC vendor specific errors.
| Error code | Value | Decimal | Description |
| ESME_ROK | 0x00000000 | 0 | No Error |
| ESME_RINVMSGLEN | 0x00000001 | 1 | Message Length is invalid |
| ESME_RINVCMDLEN | 0x00000002 | 2 | Command Length is invalid |
| ESME_RINVCMDID | 0x00000003 | 3 | Invalid Command ID |
| ESME_RINVBNDSTS | 0x00000004 | 4 | Incorrect BIND Status for given command |
| ESME_RALYBND | 0x00000005 | 5 | ESME Already in Bound State |
| ESME_RINVPRTFLG | 0x00000006 | 6 | Invalid Priority Flag |
| ESME_RINVREGDLVFLG | 0x00000007 | 7 | Invalid Registered Delivery Flag |
| ESME_RSYSERR | 0x00000008 | 8 | System Error |
| ESME_RINVSRCADR | 0x0000000A | 10 | Invalid Source Address |
| ESME_RINVDSTADR | 0x0000000B | 11 | Invalid Destination Address |
| ESME_RINVMSGID | 0x0000000C | 12 | Message ID is invalid |
| ESME_RBINDFAIL | 0x0000000D | 13 | Bind Failed |
| ESME_RINVPASWD | 0x0000000E | 14 | Invalid Password |
| ESME_RINVSYSID | 0x0000000F | 15 | Invalid System ID |
| ESME_RCANCELFAIL | 0x00000011 | 17 | Cancel SM Failed |
| ESME_RREPLACEFAIL | 0x00000013 | 19 | Replace SM Failed |
| ESME_RMSGQFUL | 0x00000014 | 20 | Message Queue Full |
| ESME_RINVSERTYP | 0x00000015 | 21 | Invalid Service Type |
| ESME_RINVNUMDESTS | 0x00000033 | 51 | Invalid number of destinations |
| ESME_RINVDLNAME | 0x00000034 | 52 | Invalid Distribution List name |
| ESME_RINVDESTFLAG | 0x00000040 | 64 | Destination flag is invalid (submit_multi) |
| ESME_RINVSUBREP | 0x00000042 | 66 | Invalid ‘submit with replace’ request (i.e. submit_sm withreplace_if_present_flag set) |
| ESME_RINVESMCLASS | 0x00000043 | 67 | Invalid esm_class field data |
| ESME_RCNTSUBDL | 0x00000044 | 68 | Cannot Submit to Distribution List |
| ESME_RSUBMITFAIL | 0x00000045 | 69 | submit_sm or submit_multi failed |
| ESME_RINVSRCTON | 0x00000048 | 72 | Invalid Source address TON |
| ESME_RINVSRCNPI | 0x00000049 | 73 | Invalid Source address NPI |
| ESME_RINVDSTTON | 0x00000050 | 80 | Invalid Destination address TON |
| ESME_RINVDSTNPI | 0x00000051 | 81 | Invalid Destination address NPI |
| ESME_RINVSYSTYP | 0x00000053 | 83 | Invalid system_type field |
| ESME_RINVREPFLAG | 0x00000054 | 84 | Invalid replace_if_present flag |
| ESME_RINVNUMMSGS | 0x00000055 | 85 | Invalid number of messages |
| ESME_RTHROTTLED | 0x00000058 | 88 | Throttling error (ESME has exceeded allowed message limits) |
| ESME_RINVSCHED | 0x00000061 | 97 | Invalid Scheduled Delivery Time |
| ESME_RINVEXPIRY | 0x00000062 | 98 | Invalid message validity period (Expiry time) |
| ESME_RINVDFTMSGID | 0x00000063 | 99 | Predefined Message Invalid or Not Found |
| ESME_RX_T_APPN | 0x00000064 | 100 | ESME Receiver Temporary App Error Code |
| ESME_RX_P_APPN | 0x00000065 | 101 | ESME Receiver Permanent App Error Code |
| ESME_RX_R_APPN | 0x00000066 | 102 | ESME Receiver Reject Message Error Code |
| ESME_RQUERYFAIL | 0x00000067 | 103 | query_sm request failed |
| ESME_RINVOPTPARSTREAM | 0x000000C0 | 192 | Error in the optional part of the PDUBody. |
| ESME_ROPTPARNOTALLWD | 0x000000C1 | 193 | Optional Parameter not allowed |
| ESME_RINVPARLEN | 0x000000C2 | 194 | Invalid Parameter Length. |
| ESME_RMISSINGOPTPARAM | 0x000000C3 | 195 | Expected Optional Parameter missing |
| ESME_RINVOPTPARAMVAL | 0x000000C4 | 196 | Invalid Optional Parameter Value |
| ESME_RDELIVERYFAILURE | 0x000000FE | 254 | Delivery Failure (used fordata_sm_resp) |
| ESME_RUNKNOWNERR | 0x000000FF | 255 | Unknown Error |