SMPP Error Codes

These error codes are returned with submit_sms_resp PDUs. They indicate either an issue with the format or structure of your request, or an issue with delivery to the mobile phone.

As well as these pre-defined SMPP error codes, there are OpenMarket-Specific SMPP Error Codes. We use these to better indicate what may have caused the request to fail. We may also provide further information as to why a message request failed in TLV 0x2153. This TLV provides the most accurate information about why a message may have failed. For a list of the codes returned by TLV 0x2153, see TLVs returned in responses and delivery receipts.

Search for a code or on any other text:

Hex value

Decimal

Description

Possible solution

0x00000000

0

No Error

 

0x00000001

1

Message length is invalid

Max 140 octets; 160 chars in uncompressed default character encoding.

0x00000002

2

Command length is invalid

 

0x00000003

3

Invalid Command ID

 

0x00000004

4

Incorrect BIND Status for given command

You must bind first before any other request is handled.

0x00000005

5

ESME Already in Bound State

Do not send bind requests when already bound.

0x00000006

6

Invalid Priority Flag

 

0x00000007

7

Invalid Registered Delivery Flag

 

0x00000008

8

System Error

 

0x00000009

 

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

Reserved

 

0x00000011

17

Cancel SM Failed

 

0x00000012

 

Reserved

 

0x00000013

19

Replace SM Failed

 

0x00000014

20

Message Queue Full

 

0x00000015

21

Invalid Service Type

Set to NULL

0x00000016

 

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

 

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

 

0x00000045

69

submit_sm or submit_multi failed

 

0x00000046

 

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

 

0x00000061

97

Invalid Scheduled Delivery Time

 

0x00000062

98

Invalid message validity period (Expiry time).

 

0x00000063

99

Predefined Message Invalid or Not Found

Does not support canned messages; set to NULL.

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

Reserved thru -0x000000BF

 

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.

 

 

0x000000C5-0x000000FD

 

0x000000FE

245

Delivery Failure, used for data_sm_resp

 

0x000000FF

255

Unknown Error

 

0x00000100

 

Reserved for SMPP extension thru -0x000003FF