SMS Error Codes
The following table lists some of the significant SMS error codes.
SMS Status Codes
| Status | Code | Description |
|---|---|---|
| failed | 9999 | Unknown error from downstream. Carrier reported a failure code that is unknown to aggregator |
| sent | 9902 | Timed out waiting for delivery receipt. The reason a delivery receipt was not received is not known |
| failed | 5650 | Carrier Service Failure. Destination failed |
| failed | 5630 | Carrier Application Error. Message not acknowle |
| failed | 5620 | Carrier Application Error. Destination app error |
| failed | 5610 | Carrier Service Failure |
| failed | 5600 | Carrier Service Unavailable |
| failed | 5999 | Unknown error from aggregator |
| failed | 5501 | General Message Send Failure. The message is unable to send as no destination is available |
| failed | 5500 | General Message Send Failure. The destination carrier has reported a general service failure with sending the message |
| failed | 5231 | Aggregator did not receive all parts of message. Message can not be sent |
| failed | 5220 | Message not received. Cannot save message to store |
| failed | 5211 | Aggregator service application is temporarily busy so it cannot receive messages at this time |
| failed | 5201 | Aggregator service expired the message after attempts to deliver through retries failed |
| failed | 5111 | Received messaged for connection which is already removed |
| failed | 5106 | Impossible to route / Attempt to deliver through retries has failed |
| failed | 5101 | Application Error. Temporary app shutdown |
| failed | 5100 | Application Error. Temporary app error |
| failed | 4793 | Carrier Rejected Short Code Expired |
| failed | 4792 | Carrier Rejected Short Code Not Provisioned |
| failed | 4791 | Carrier Rejected Short Code Campaign Not Allowed |
| failed | 4790 | Carrier Rejected Due to Short Code Restriction |
| failed | 4780 | Carrier rejected due to P2P volumetric violation |
| failed | 4775 | Carrier Rejected due to user opt out |
| failed | 4770 | Carrier Rejected as SPAM |
| failed | 4752 | Message is malformed for the carrier |
| failed | 4751 | Message is too long or message length is invalid for the carrier |
| failed | 4750 | Carrier Rejected Message |
| failed | 4740 | Carrier Rejected as Invalid Source Address |
| failed | 4730 | No route to destination carrier or no roaming route exists |
| failed | 4721 | TN on deactivation list |
| failed | 4720 | Carrier Rejected as Invalid Destination Address |
| failed | 4702 | Destination subscriber is unavailable |
| failed | 4701 | Destination is not reachable and SMS service is not available |
| failed | 4700 | Carrier Rejected as Invalid Service Type |
| failed | 4493 | Unauthorized |
| failed | 4492 | Message to emergency number forbidden |
| failed | 4482 | To Number in black list |
| failed | 4481 | From Number in black list |
| failed | 4470 | Rejected as SPAM (future) |
| failed | 4452 | Invalid Application ID |
| failed | 4451 | Invalid User Id |
| failed | 4435 | Too Many Recipients |
| failed | 4434 | Messaging to Toll Free Number Forbidden |
| failed | 4433 | Messaging on Toll Free Number Forbidden |
| failed | 4432 | Messaging to country forbidden |
| failed | 4431 | Messaging on shortcode forbidden |
| failed | 4421 | No Route to Destination Carrier |
| failed | 4420 | No Route to Destination Carrier |
| failed | 4412 | Failed to parse Content-Type for media |
| failed | 4411 | Combined size of media too large |
| failed | 4410 | Could not download media |
| failed | 4409 | Invalid destination profile |
| failed | 4408 | To Number not associated with account |
| failed | 4407 | From Number is associated with account |
| failed | 4406 | Unallocated to number |
| failed | 4405 | Unallocated from number |
| failed | 4404 | Messaging forbidden on To number |
| failed | 4403 | Messaging forbidden on From number |
| failed | 4401 | Aggregator is unable to route the message |
| failed | 4360 | Message expired |
| failed | 4350 | Malformed message encoding |
| failed | 4303 | Malformed To Number |
| failed | 4302 | Malformed From number |
| failed | 4301 | Malformed message encoding |
| failed | 4001 | Message was rejected for reasons other than those covered by other 4xxx codes |
| sent | 2000 | Delivered to mobile |
| failed | 413 | The account is blocked. Reach out to support for help. Potentially out of credits. |
| failed | 412 | SMSC rejected the message. The account hasn’t been provisioned for this region. |
| failed | 411 | Message failed as the number of message parts exceeds the defined max number of message parts. |
| failed | 410 | No default originator exists/configured for this recipient when sending message without originator. |
| failed | 408 | SMSC rejected the message. Retrying is likely to cause the same error. |
| failed | 407 | Message was canceled by user before reaching SMSC. |
| failed | 406 | Message was expired before reaching SMSC. This may happen if the expiry time for the message was very short. |
| failed | 405 | One or more parameters in the message body has no mapping for this recipient |
| failed | 404 | Message failed because of temporary delivery failure. Message can be retried. |
| failed | 403 | An unexpected error caused the message to fail. |
| failed | 402 | SMSC rejected message. Retrying is likely to cause the same error. |
| sent | 401 | Message has been dispatched to SMSC. |
| in_progress | 400 | Message is queued within REST API system and will be dispatched according to the rate of the account. |
| failed | 399 | Unknown |
| failed | 370 | Can’t find information |
| failed | 362 | External error |
| failed | 361 | External error |
| failed | 360 | Message queue full |
| failed | 350 | Invalid delivery report request |
| failed | 349 | Request failed |
| failed | 348 | Invalid replace flag |
| failed | 347 | Invalid priority |
| failed | 346 | Invalid predefined message |
| failed | 345 | Invalid number of messages |
| failed | 344 | Invalid message reference |
| failed | 343 | Invalid message length |
| failed | 342 | Invalid message class |
| failed | 341 | Invalid distribution list |
| failed | 340 | Invalid scheduled delivery parameter |
| failed | 339 | Invalid validity parameter |
| failed | 338 | Optional parameter missing |
| failed | 337 | Invalid optional parameter |
| failed | 336 | Invalid parameter length |
| failed | 335 | Parameter not allowed |
| failed | 334 | Invalid parameter |
| failed | 333 | Operation not allowed |
| failed | 332 | Invalid operation |
| failed | 331 | Invalid service type |
| failed | 330 | Invalid command length |
| failed | 322 | ESME Receiver temporary error |
| failed | 321 | ESME Receiver reject error |
| failed | 320 | ESME Receiver permanent error |
| failed | 312 | Invalid source type of number |
| failed | 311 | Invalid source numbering plan |
| failed | 310 | Invalid source address |
| failed | 304 | Invalid number of destinations |
| failed | 303 | Invalid destination flag |
| failed | 302 | Invalid destination type of number |
| failed | 301 | Invalid destination numbering plan |
| failed | 300 | Invalid destination address |
| failed | 257 | Error, personal service barring, MT Operator |
| failed | 256 | Error, personal service barring, MT Operator |
| failed | 255 | Error, personal service barring, MT Personal |
| failed | 254 | Error, personal service barring, MT Personal |
| failed | 253 | Error, personal service barring, MO Operator |
| failed | 252 | Error, personal service barring, MO Operator |
| failed | 251 | Error, personal service barring, MO Personal |
| failed | 250 | Error, personal service barring, MO Personal |
| failed | 217 | Unknown error |
| failed | 216 | Exception (internal) |
| failed | 215 | Abort |
| failed | 214 | Local Cancel |
| failed | 213 | Reject |
| failed | 212 | Equipment not short message equipped |
| failed | 211 | Equipment protocol error |
| failed | 210 | Memory capacity exceeded |
| failed | 209 | Data missing |
| failed | 208 | Unexpected data value |
| failed | 207 | System failure |
| failed | 206 | Illegal equipment |
| failed | 205 | Illegal subscriber |
| failed | 204 | Facility not supported |
| failed | 203 | Subscriber busy for MT SMS |
| failed | 202 | Absent subscriber, no page response |
| failed | 201 | Absent subscriber, IMSI detached |
| failed | 200 | Unidentified subscriber |
| failed | 164 | Unknown error |
| failed | 163 | Exception (internal) |
| failed | 162 | Abort |
| failed | 161 | Local Cancel |
| failed | 160 | Reject |
| failed | 159 | Mobile subscriber not reachable |
| failed | 158 | Memory capacity exceeded |
| failed | 157 | Data missing |
| failed | 156 | Unexpected data value |
| failed | 155 | System failure |
| failed | 154 | Facility not supported |
| failed | 153 | Absent subscriber |
| failed | 152 | Teleservice not provisioned |
| failed | 151 | Call barred |
| failed | 150 | Unknown subscriber |
| failed | 114 | Unknown error |
| failed | 113 | Exception (internal) |
| failed | 112 | Abort |
| failed | 111 | Local Cancel |
| failed | 110 | Reject |
| failed | 109 | Subscriber not service centre subscriber |
| failed | 108 | Invalid short message entity address |
| failed | 107 | Service center congestion |
| failed | 106 | Unknown service center address |
| failed | 105 | Equipment protocol error |
| failed | 104 | Data missing |
| failed | 103 | Unexpected data value |
| failed | 102 | System failure |
| failed | 101 | Facility not supported |
| failed | 100 | Unidentified Subscriber |
| failed | 77 | IMSI lookup blocked |
| failed | 76 | Internal error |
| failed | 75 | Internal error |
| failed | 74 | Internal error |
| failed | 73 | Internal error |
| failed | 72 | Internal error |
| failed | 71 | Internal error |
| failed | 70 | Internal error |
| failed | 67 | Error, information element identifier blocked |
| failed | 66 | Error, data coding scheme blocked |
| failed | 65 | Error, loop detected |
| failed | 64 | Error, blocked due to exceeded quota |
| failed | 63 | Error, SC address blocked |
| failed | 62 | Error, keyword blocked |
| failed | 61 | Error, destination blocked |
| failed | 60 | Error, originator blocked |
| failed | 56 | Internal error |
| failed | 55 | Internal error |
| failed | 54 | Internal error |
| failed | 53 | Internal error |
| failed | 52 | Internal error |
| failed | 51 | Internal error |
| failed | 50 | Internal error |
| failed | 40 | Internal error |
| failed | 35 | Error, Low balance. |
| failed | 19 | Originating location mismatch |
| failed | 18 | ESME error |
| failed | 17 | Destination network type unknown |
| failed | 16 | Terminating IMSI blocked |
| failed | 15 | Screening block |
| failed | 14 | Not home zone and IMSI fetch failed |
| failed | 13 | Not home zone and IMSI not allowed |
| failed | 12 | Dialing zone not found |
| failed | 11 | Message not delivered |
| failed | 10 | Unsupported type of number |
| failed | 9 | Unsupported number plan |
| failed | 8 | Internal routing error |
| failed | 7 | Internal routing error |
| failed | 6 | Internal routing error |
| failed | 5 | Internal routing error |
| failed | 4 | Internal routing error |
| failed | 3 | Internal routing error |
| failed | 2 | Internal routing error |
| failed | 1 | Internal routing error |
| sent | 0 | No error / Unknown error |
| failed | DBF7 | Message rejected by Operator. Exceed more than 50MT per month not allowed |
| failed | DBF6 | Message rejected by Operator. User must send MO to unblock messages |
| failed | DBF5 | End User roamed on an unreachable network |
| failed | DBF3 | Retry currently done on message |
| failed | DBF2 | Message rejected by Operator. This a generic error |
| failed | DBF1 | Message rejected by aggregator Output Interface. Message not sent to Operator |
| failed | DBA7 | Temporary Traffic Congestion (Sunday) |
| failed | DBA6 | SMSC currently busy |
| failed | DBA5 | Subscriber SIM Card Full (Sunday) |
| failed | DBA4 | Subscriber cannot be reached (Sunday) |
| failed | DBA3 | Handset cannot be reached (Sunday) |
| sms_incapable | DB99 | Unknown or ported number |
| failed | DB85 | Message Validity Period Expired (KGT) |
| failed | DB81 | BLACKLISTED |
| failed | DB80 | ACK_ONLY |
| failed | DB78 | Billing no balance |
| failed | DB77 | Server internal error |
| failed | DB76 | Subscriber profile does not permit service. Invalid subscription |
| failed | DB74 | Bad request |
| failed | DB73 | Connection to SMSC failed |
| failed | DB71 | No response from SMSC |
| failed | DB70 | Distant operator network failure |
| failed | DB69 | Brite subscriber |
| failed | DB67 | MS error |
| failed | DB66 | SMS not provisioned |
| failed | DB65 | Validity period expired |
| failed | DB64 | Facility not supported |
| sms_incapable | DB63 | Unknown subscriber |
| failed | DB62 | Failed message delivery. Temporary Operator Network error |
| failed | DB60 | Data format not supported |
| failed | DB58 | Invalid size |
| failed | DB56 | Status unknown |
| failed | DB55 | Operator network error |
| failed | DB54 | Too many connection |
| failed | DB53 | Server busy |
| failed | DB52 | Failed message delivery. Rejected by operator |
| failed | DB51 | Invalid pwd ID |
| sms_incapable | DB48 | Invalid MSISDN |
| sms_incapable | DB47 | ADC invalid |
| failed | DB46 | validity period not valid |
| failed | DB44 | Memory capacity exceeded |
| failed | DB43 | Teleservice not provisioned |
| failed | DB42 | No msg associated |
| failed | DB37 | Delivery in progress |
| failed | DB36 | RPID already in use |
| failed | DB35 | Customer busy |
| failed | DB24 | MSG_TOO_LONG |
| failed | DB23 | MSG_TYPE_NOT_SUPPORTED |
| failed | DB22 | TIME_PERIOD_NOT_VALID |
| failed | DB19 | NEW_AC_NOT_VALID |
| failed | DB16 | REVERS_CHARG_NOT_ALLOWED |
| failed | DB11 | REPET_LEG_FAILURE |
| failed | DB07 | AUTH_FAILURE |
| failed | DB05 | Call barred by destination operator |
| failed | DB04 | Operator connection error |
| failed | DB03 | SMS service not available |
| failed | DB02 | SYNTAX_ERROR |
| failed | DA11 | Invalid TPOA |
| sms_incapable | DA10 | Invalid MSISDN |
| sent | 451A | Delivered to mobile |
| sent | 450A | Msg received by SMSC |
| failed | 450D | Msg refused by billing |
| in_progress | 450E | Delivered to SMSC |
| sms_incapable | 4530 | Customer Blacklisted |
| failed | 4529 | NRS error |
| failed | 4527 | Unknown SMSC |
| failed | 4526 | Unknown operator |
| sms_incapable | 4525 | Trashed Messages on customer request |
| sms_incapable | 4524 | Trashed Messages |
| failed | 4518 | No SMSC found to send UDH |
| in_progress | 4510 | Msg processed by aggregator |
| in_progress | 4507 | Msg received by SMSC |
| failed | 4503 | No SMSC found for current MSISDN |