Skip to content

Error code index

We do our best to keep this list updated, but you may encounter errors not listed here. If you get an error, it will always be accompanied with an error description which you can find the description of in this list.

All GatewayAPI error codes follow the same pattern. They are a 32-bit unsigned integer, often represented in hex format as four hex chars, ie. 0x104A. The first two hex chars (first byte) represent the origin of the error. The following list of error codes are divided into sections depending on the origin.

General error codes

Regardless of the error origin, all error codes that end in 00-0F, have the same meaning. These do not map to a specific error but may be caused by different issues depending on the context. Thus these are left undocumented since the exact cause varies.

Code Description
00 Success (no error)
01 Unknown error
02 Generic NACK
03 Operation not permitted
04 Input/output error
05 Shutting down
06 Insufficient Resources
07 Permission denied
08 Invalid Argument
09 Resource temporarily unavailable (EAGAIN)

This means that if you get an 0x1001, it is an “Unknown error” from the SMS Errors. If you get an 0x0308 it is an “Invalid Argument” from API Errors etc.

API Errors

These cover codes 0x0100-0x07FF. You might encounter these when communicating with one of our APIs i.e. REST API.

Code HTTP Status Code Description
0x0210 401 Invalid username: %1
0x0210 401 Invalid username: %1
0x0211 401 Invalid password
0x0212 401 Invalid IP-address: %1
0x0213 403 Unauthorized IP-address: %1
0x0214 403 Temporary blacklist for MSISDN %1 with hash %2
0x0215 403 MSISDN %1 blacklisted
0x0216 403 Insufficient credit
0x0217 403 Unauthorized destination: country %1
0x0218 422 Unknown message class id %1
0x0219 403 E-mail not enabled for account
0x021A 403 HLR not enabled for account
0x021B 403 Phonebook not enabled for account
0x021C 403 MMS not enabled for account
0x021D 403 SMS not enabled for account
0x021E 500 Message class %1 is not configured for %2
0x021F 403 Unauthorized operator: MCC %1, MNC %2
0x0220 400 Unsupported parameter %1
0x0221 400 Unsupported signature method %1
0x0222 400 Missing required parameter %1
0x0223 401 Invalid Consumer Key
0x0224 401 Invalid signature
0x0225 401 Expired timestamp
0x0226 401 Invalid / used nonce
0x0229 401 Invalid token
0x022A 403 Account frozen, contact support
0x0310 422 A message contains the same recipient more than once. MSISDNs %1 is duplicated
0x0312 422 Messages filtered based on content
0x0313 422 A message recipient belongs to a blocked country

SMS Errors

The following table is an exhaustive list of error codes that might be returned to you in a Delivery Status Notification. We do our best to keep track of all these, but some may be missing. Not all error codes are relevant or expected to occur in normal operations. This section covers codes 0x0100-0x01FF.

These supplement the states to provide additional insight on failures.

Group Code Description
HLR 0x1001 Unspecified delivery error
HLR 0x1010 Unknown subscriber
HLR 0x1011 Call barred
HLR 0x1012 Teleservice not provisioned
HLR 0x1013 Absent subscriber
HLR 0x1014 Facility not supported
HLR 0x1015 HLR System failure
HLR 0x1016 Unexpected data value
HLR 0x1017 HLR Data missing
HLR 0x1018 Memory capacity exceeded
HLR 0x1019 Mobile subscriber not reachable
HLR 0x101A VLR System failure
HLR 0x101B HLR Internal Error
MSC 0x1020 Unidentified subscriber
MSC 0x1021 Absent subscriber, IMSI detached
MSC 0x1022 Absent subscriber, no page response
MSC 0x1023 Subscriber busy for MT SMS
MSC 0x1024 Facility not supported
MSC 0x1025 Illegal subscriber
MSC 0x1026 Illegal equipment
MSC 0x1027 System failure
MSC 0x1028 Unexpected data value
MSC 0x1029 Data missing
MSC 0x102A Memory capacity exceeded
MSC 0x102B Equipment protocol error
MSC 0x102C Equipment not short message equipped
MSC 0x102D Illegal error
MSC 0x102E MSC Internal Error
SCREEN 0x1030 Screening block
SCREEN 0x1031 Terminating IMSI blocked
SCREEN 0x1032 Originating location mismatch
SCREEN 0x1033 Error, originator blocked
SCREEN 0x1034 Error, destination blocked
SCREEN 0x1035 Error, keyword blocked
SCREEN 0x1036 Error, SC address blocked
SCREEN 0x1037 Error, blocked due to exceeded quota
SCREEN 0x1038 Error, loop detected
SCREEN 0x1039 Error, data coding scheme blocked
SCREEN 0x103A Error, information element identifier blocked
SCREEN 0x103B Error, personal service barring, MO
SCREEN 0x103C Error, personal service barring, MT
SMSC 0x1040 Unidentified Subscriber
SMSC 0x1041 Facility not supported
SMSC 0x1042 System failure
SMSC 0x1043 Unexpected data value
SMSC 0x1044 Data missing
SMSC 0x1045 Equipment protocol error
SMSC 0x1046 Unknown service centre address
SMSC 0x1047 Service centre congestion
SMSC 0x1048 Invalid short message entity address
SMSC 0x1049 Subscriber not service centre subscriber
SMSC 0x104A SMSC Internal Error
ROUTE 0x1050 Internal routing error
ROUTE 0x1051 Unsupported number plan
ROUTE 0x1052 Unsupported type of number
ROUTE 0x1053 Message not delivered
ROUTE 0x1054 Dialling zone not found
ROUTE 0x1055 Not home zone and IMSI not allowed
ROUTE 0x1056 Not home zone and IMSI fetch failed
ROUTE 0x1057 Destination network type unknown
ESME 0x1060 Invalid destination address
ESME 0x1061 Invalid destination numbering plan
ESME 0x1062 Invalid destination type of number
ESME 0x1063 Invalid destination flag
ESME 0x1064 Invalid number of destinations
ESME 0x1065 Invalid source address
ESME 0x1066 Invalid source numbering plan
ESME 0x1067 Invalid source type of number
ESME 0x1068 ESME Receiver permanent error
ESME 0x1069 ESME Receiver reject error
ESME 0x106A ESME Receiver temporary error
ESME 0x106B Invalid command length
ESME 0x106C Invalid service type
ESME 0x106D Invalid operation
ESME 0x106E Operation not allowed
ESME 0x106F Invalid parameter
ESME 0x1070 Parameter not allowed
ESME 0x1071 Invalid parameter length
ESME 0x1072 Invalid optional parameter
ESME 0x1073 Optional parameter missing
ESME 0x1074 Invalid validity parameter
ESME 0x1075 Invalid scheduled delivery parameter
ESME 0x1076 Invalid distribution list
ESME 0x1077 Invalid message class
ESME 0x1078 Invalid message length
ESME 0x1079 Invalid message reference
ESME 0x107A Invalid number of messages
ESME 0x107B Invalid predefined message
ESME 0x107C Invalid priority
ESME 0x107D Invalid replace flag
ESME 0x107E Request failed
ESME 0x107F Invalid delivery report request
ESME 0x1080 Message queue full
ESME 0x1081 External error
ESME 0x1082 Cannot find information
ESME 0x1081 IMSI lookup blocked
ESME 0x1082 ESME error
ESME 0x1082 ESME Internal error
ESME 0x1083 ESME Unknown external error
ESME 0x1084 Invalid Mobile Subscriber
ESME 0x1085 Short message exceeds maximum
ESME 0x1086 Unable to Unpack GSM message
ESME 0x1087 Unable to convert IRA Alphabet
SP 0x1090 Internal error
SP 0x1091 Network time-out
SP 0x1092 Operation barred - insufficient funds
SP 0x1093 Illegal mobile subscriber - blocked
SP 0x1094 Refunded by network operator
GWAPI 0x1902 Messageclass not configured
GWAPI 0x1903 Link not whitelisted
GWAPI 0x1904 Message filtered by content
GWAPI 0x1905 Unsupported sender
GWAPI 0x1906 Destination blocked - Pre-approval required
GWAPI 0x1907 Unreachable pattern detected