Error Codes

SMPP error codes indicating the outcome of an SMPP operation.

Error CodeValue (hex)Description
ESME_ROK0x00000000No Error
ESME_RINVMSGLEN0x00000001Message Length is invalid
ESME_RINVCMDLEN0x00000002Command Length is invalid
ESME_RINVCMDID0x00000003Invalid Command ID
ESME_RINVBNDSTS0x00000004Incorrect BIND Status for given command
ESME_RALYBND0x00000005ESME Already in Bound State
ESME_RINVPRTFLG0x00000006Invalid Priority Flag
ESME_RINVREGDLVFLG0x00000007Invalid Registered Delivery Flag
ESME_RSYSERR0x00000008System Error
ESME_RINVSRCADR0x0000000AInvalid Source Address
ESME_RINVDSTADR0x0000000BInvalid Dest Addr
ESME_RINVMSGID0x0000000CMessage ID is invalid
ESME_RBINDFAIL0x0000000DBind Failed
ESME_RINVPASWD0x0000000EInvalid Password
ESME_RINVSYSID0x0000000FInvalid System ID
ESME_RCANCELFAIL0x00000011Cancel SM Failed
ESME_RREPLACEFAIL0x00000013Replace SM Failed
ESME_RMSGQFUL0x00000014Message Queue Full
ESME_RINVSERTYP0x00000015Invalid Service Type
ESME_RINVNUMDESTS0x00000033Invalid number of destinations
ESME_RINVDLNAME0x00000034Invalid Distribution List name
ESME_RINVDESTFLAG0x00000040Destination flag is invalid
(submit_multi)
ESME_RINVSUBREP0x00000042Invalid ‘submit with replace’ request
(i.e. submit_sm with
replace_if_present_flag set)
ESME_RINVESMCLASS0x00000043Invalid esm_class field data
ESME_RCNTSUBDL0x00000044Cannot Submit to Distribution List
ESME_RSUBMITFAIL0x00000045submit_sm or submit_multi failed

Also returned for insufficient balance or unsupported data_coding field data.
ESME_RINVSRCTON0x00000048Invalid Source address TON
ESME_RINVSRCNPI0x00000049Invalid Source address NPI
ESME_RINVDSTTON0x00000050Invalid Destination address TON
ESME_RINVDSTNPI0x00000051Invalid Destination address NPI
ESME_RINVSYSTYP0x00000053Invalid system_type field
ESME_RINVREPFLAG0x00000054Invalid replace_if_present flag
ESME_RINVNUMMSGS0x00000055Invalid number of messages
ESME_RTHROTTLED0x00000058Throttling error (ESME has exceeded
allowed message limits)
ESME_RINVSCHED0x00000061Invalid Scheduled Delivery Time
ESME_RINVEXPIRY0x00000062Invalid message validity period
(Expiry time)
ESME_RINVDFTMSGID0x00000063Predefined Message Invalid or Not
Found
ESME_RX_T_APPN0x00000064ESME Receiver Temporary App
Error Code
ESME_RX_P_APPN0x00000065ESME Receiver Permanent App Error
Code
ESME_RX_R_APPN0x00000066ESME Receiver Reject Message Error
Code
ESME_RQUERYFAIL0x00000067query_sm request failed
ESME_RINVOPTPARSTREAM0x000000C0Error in the optional part of the PDU
Body.
ESME_ROPTPARNOTALLWD0x000000C1Optional Parameter not allowed
ESME_RINVPARLEN0x000000C2Invalid Parameter Length.
ESME_RMISSINGOPTPARAM0x000000C3Expected Optional Parameter missing
ESME_RINVOPTPARAMVAL0x000000C4Invalid Optional Parameter Value
ESME_RDELIVERYFAILURE0x000000FEDelivery Failure (used for
data_sm_resp)
ESME_RUNKNOWNERR0x000000FFUnknown Error