When using our API, you may encounter certain status code and description that you need to understand or troubleshoot. This page contains a list of all codes with thorough descriptions and action steps you need to take if you are looking to resolve a problem.
Status Code | Description |
---|---|
0 | Unprocessed |
1 | Delivered |
2 | Failed |
3 | Sent |
6 | In Progress |
8 | Invalid Mobile Number |
9 | Opt Out Number |
10 | Undelivered |
Error ID | Error Code | Description |
---|---|---|
1 | EC_UNKNOWN_SUBSCRIBER | Typically, this indicates that the subscriber or recipient of the message is unknown or not recognized by the network. It means that the provided subscriber information, such as the phone number, does not exist or is an unknown user in the network's database. To resolve this error, it is recommended to verify the accuracy of the subscriber details by dialing the provided number. If the number is available, contact support for assistance. |
3 | EC_UNKNOWN_MSC | Absent subscriber is a permanent error and as such messages should not be retried. It refers to messages sent to numbers no longer active, which should be removed from client database. |
4 | PORTED_NUMBER | Ported number error from operator |
5 | EC_UNIDENTIFIED_SUBSCRIBER | This can occur for various reasons, such as an invalid or unregistered number, incomplete or incorrect subscriber information, or technical issues retrieving subscriber details. Resolving this error typically involves verifying and correcting the subscriber information and if the destination is correct and available, contact support for assistance. |
6 | EC_ABSENT_SUBSCRIBER_SM | This indicates that the destination numbers provided during the submissions were unreachable (not properly connected to the operator's network), powered off, or located in an area with limited/low coverage or subject to roaming restrictions. Resolving this error ensures that the subscriber's device is turned on and has a stable network connection. |
7 | EC_UNKNOWN_EQUIPMENT | The mobile device has not been recognized by EIR (Equipment Identity Register) during device verification on the MAP protocol level at the operator’s infrastructure. |
8 | EC_ROAMING_NOT_ALLOWED | The subscriber is currently roaming in another country or another operator’s infrastructure – roaming delivery is not guaranteed due to a lack of roaming agreements between many different operators. |
9 | EC_ILLEGAL_SUBSCRIBER | Indicates that the mobile station failed authentication, often due to the subscriber's number being blocklisted or subscribed. Resolving this error typically involves investigating and addressing the underlying reasons for the subscriber's illegal status, which may involve contacting the network operator, or contact support for assistance. |
10 | EC_BEARER_SERVICE_NOT_PROVISIONED | Suggests that the requested bearer service is not available or activated for the user or device attempting to access it. This can be due to service unavailability in the subscription, lack of network support, or configuration/provisioning issues. Resolving this error typically involves contacting the service provider or network operator to ensure the necessary bearer service is provisioned and activated for the subscriber's account. |
11 | EC_TELESERVICE_NOT_PROVISIONED | This indicates that the mobile subscription associated with this number does not support the short message service (SMS). It means that the requested service, such as SMS, is not available or activated for the subscriber's account. Resolving this error usually involves contacting the service provider or network operator to ensure the necessary teleservice is provisioned and activated for the subscriber's account. |
12 | EC_ILLEGAL_EQUIPMENT | The IMEI check on the handset failed, indicating that the IMEI of the device is either blocklisted or unauthorized according to the system. Resolving this error typically involves ensuring the use of authorization. |
13 | EC_CALL_BARRED | The operator suspended the subscriber's service, usually because of unpaid invoices. Resolving this error usually involves checking the subscriber's account status, ensuring sufficient balance or subscription plan, and contacting the network operator to lift any call barring restrictions if necessary. |
14 | UNREGISTERED_SENDER_ID | Sender ID not pre-registered |
15 | WRONGNUM_FORMAT | This recipient has the wrong digit length for this destinations. It may be too long or too short. |
16 | BLOCKED_SENDERS | This sender ID is blocked in this destination |
20 | EC_SS_INCOMPATIBILITY | Supplementary service incompatibility |
21 | EC_FACILITY_NOT_SUPPORTED | The requested functionality or service is not supported by the handset or the network being used due to limitations, restrictions, or incompatibility. Resolving this error typically involves verifying the supported facilities or services, ensuring the subscriber's compatibility with the requested feature, and handset devices restart, and applying the newest software/firmware updates. |
26 | EC_SUBSEQUENT_HANDOVER_FAILURE | Subscriber is temporarily unavailable |
27 | EC_ABSENT_SUBSCRIBER | This indicates that the destination numbers provided during the submissions were unreachable (not properly connected to the operator's network), powered off, or located in an area with limited/low coverage or subject to roaming restrictions. Resolving this error involves ensuring that the subscriber's device is turned on and has a stable network connection. |
28 | EC_ABSENT_SUBSCRIBER_NO_PAGE | Absent subscriber, there was no paging response from the handset |
29 | EC_ABSENT_SUBSCRIBER_IMSI_DETACHED | Absent subscriber, No IMSI attached. |
30 | EC_CONTROLLING_MSC_FAILURE | Receiver's network is experiencing some temporary issue |
31 | EC_SUBSCRIBER_BUSY_FOR_MT_SMS | Subscriber Busy For MT SMS |
32 | EC_SM_DELIVERY_FAILURE | Indicates that there was a failure in delivering an SMS message to the intended recipient. The failure may be related to the recipient's unavailability, memory capacity issues, or temporary communication issues between the operator and the end user. Resolving this error may involve verifying recipient details, or contact support to investigate any potential network or configuration issues. |
33 | EC_MESSAGE_WAITING_LIST_FULL | Message Waiting List Full |
34 | EC_SYSTEM_FAILURE | System Failure |
35 | EC_DATA_MISSING | Data Missing |
36 | EC_UNEXPECTED_DATA_VALUE | Unexpected Data Value |
37 | EC_SYSTEM_FAILURE_2 | System failure at operator side |
38 | EC_DATA_MISSING_2 | Missing data value in the header of the SMS |
39 | EC_UNEXPECTED_DATA_VALUE_2 | Unexpected data value in the header of the SMS |
40 | EC_MEMORY_CAPACITY_EXCEEDED | Indicates that the message inbox on the recipient's mobile phone is currently full, preventing the storage of new messages. To resolve this issue, delete the messages and clear the message inbox on the end user handset. |
42 | EC_MT_HANDSET_NOT_SUPPORT_SMS | MT handset is not equipped to support SMS |
51 | EC_RESOURCE_LIMITATION | Indicates that invoked MAP operation could not be finished due to the network congestion – this is an SS7 network congestion error on the MAP protocol level. |
69 | NOT_IN_SERVICE | Absent subscriber due to GPRS MS purged in VLR |
71 | EC_UNKNOWN_ALPHABET | Unknown Alphabet |
72 | EC_USSD_BUSY | USSD Busy. |
73 | EC_NO-COVERAGE | No coverage for requested phone number. |
74 | EC_INVALID_PREFIX | Message has been received but rejected as the number is not recognized due to an incorrect number prefix or length. This information is different for each network and is regularly updated. |
75 | EC_WRONG_ACCOUNT_TYPE | SMS sent from wrong account due to Advertising vs OTP traffic or Local vs International traffic |
76 | UNREGISTERED_URL | Message content contains a URL that requires pre-registration/whitelisting |
77 | DND | Message has been received and rejected because the user is subscribed to DND (Do Not Disturb) services, disabling any service traffic to their number. |
78 | AIT_FRAUD | AIT Fraud Detected in Traffic |
79 | SUBSCRIBER_IS_NOT_AVAILABLE | Subscriber is detected unavailable, this is often due to one of the following subscriber states (absent, unknown, call barred or teleservice is not provisioned) |
100 | OPERATOR_ERROR | Unknown Operator error |
101 | NETWORK_ERROR | Mobile operator network error. |
255 | EC_UNKNOWN_ERROR | Unknown Error |
257 | EC_SM_DF_EQUIPMENTPROTOCOLERROR | There has been a mobile subscriber equipment error. |
258 | EC_SM_DF_EQUIPMENTNOTSM_EQUIPPED | There has been a mobile subscriber equipment error. |
259 | EC_SM_DF_UNKNOWNSERVICECENTRE | There has been a mobile subscriber equipment error. |
260 | EC_SM_DF_SC_CONGESTION | There has been a mobile subscriber equipment error. |
261 | EC_SM_DF_INVALIDSME_ADDRESS | There has been a mobile subscriber equipment error. |
262 | EC_SM_DF_SUBSCRIBERNOTSC_SUBSCRIBER | There has been a mobile subscriber equipment error. |
403 | PROMOTIONAL_BLOCKLIST | Promotional Blocklist |
424 | SUBSCRIBER_NOT_IN_IYS | Subscriber not allowed in the IYS (Turkish National Database) system. Promotional messages can not be sent to receivers in Turkey if they did not consent in the IYS system. |
500 | EC_PROVIDER_GENERAL_ERROR | General network protocol error caused by incompatible operator network protocol versions or parameters between two network components. |
501 | EC_INVALID_RESPONSE_RECEIVED | Invalid Response Received |
502 | EC_NO_RESPONSE | The message has been successfully processed and forwarded to the operator, but no response was returned from the operator upon the message submit request, or such error was reverted by the operator. The error also applies to similar errors on the SS7 network level. |
503 | EC_SERVICE_COMPLETION_FAILURE | General network protocol error caused by incompatible operator network protocol versions or parameters between two network components. |
504 | EC_UNEXPECTED_RESPONSE_FROM_PEER | General network protocol error caused by incompatible operator network protocol versions or parameters between two network components. |
507 | EC_MISTYPED_PARAMETER | General network protocol error caused by incompatible operator network protocol versions or parameters between two network components. |
508 | EC_NOT_SUPPORTED_SERVICE | General network protocol error caused by incompatible operator network protocol versions or parameters between two network components. |
509 | EC_DUPLICATED_INVOKE_ID | General network protocol error caused by incompatible operator network protocol versions or parameters between two network components. |
511 | EC_INITIATING_RELEASE | Initiating Release |
1024 | EC_OR_APPCONTEXTNOTSUPPORTED | General network protocol error caused by incompatible operator network protocol versions or parameters between two network components. |
1025 | EC_OR_INVALIDDESTINATIONREFERENCE | General network protocol error caused by incompatible operator network protocol versions or parameters between two network components. |
1026 | EC_OR_INVALIDORIGINATINGREFERENCE | General network protocol error caused by incompatible operator network protocol versions or parameters between two network components. |
1027 | EC_OR_ENCAPSULATEDAC_NOTSUPPORTED | General network protocol error caused by incompatible operator network protocol versions or parameters between two network components. |
1028 | EC_OR_TRANSPORTPROTECTIONNOTADEQUATE | General network protocol error caused by incompatible operator network protocol versions or parameters between two network components. |
1030 | EC_OR_POTENTIALVERSIONINCOMPATIBILITY | General network protocol error caused by incompatible operator network protocol versions or parameters between two network components. |
1031 | EC_OR_REMOTENODENOTREACHABLE | Mobile subscriber was not reachable due to a network operator protocol error. |
1152 | EC_NNR_NOTRANSLATIONFORANADDRESSOFSUCHNATURE | Mobile subscriber was not reachable due to a network operator protocol error. |
1153 | EC_NNR_NOTRANSLATIONFORTHISSPECIFICADDRESS | No Translation For This Specific Address |
1154 | EC_NNR_SUBSYSTEMCONGESTION | Mobile subscriber was not reachable due to a network operator protocol error. |
1155 | EC_NNR_SUBSYSTEMFAILURE | Mobile subscriber was not reachable due to a network operator protocol error. |
1156 | EC_NNR_UNEQUIPPEDUSER | Mobile subscriber was not reachable due to a network operator protocol error. |
1157 | EC_NNR_MTPFAILURE | Mobile subscriber was not reachable due to a network operator protocol error. |
1158 | EC_NNR_NETWORKCONGESTION | Mobile subscriber was not reachable due to a network operator protocol error. |
1159 | EC_NNR_UNQUALIFIED | Mobile subscriber was not reachable due to a network operator protocol error. |
1160 | EC_NNR_ERRORINMESSAGETRANSPORTXUDT | Mobile subscriber was not reachable due to a network operator protocol error. |
1161 | EC_NNR_ERRORINLOCALPROCESSINGXUDT | Mobile subscriber was not reachable due to a network operator protocol error. |
1162 | EC_NNR_DESTINATIONCANNOTPERFORMREASSEMBLYXUDT | Mobile subscriber was not reachable due to a network operator protocol error. |
1163 | EC_NNR_SCCPFAILURE | Mobile subscriber was not reachable due to a network operator protocol error. |
1164 | EC_NNR_HOPCOUNTERVIOLATION | Mobile subscriber was not reachable due to a network operator protocol error. |
1165 | EC_NNR_SEGMENTATIONNOTSUPPORTED | Mobile subscriber was not reachable due to a network operator protocol error. |
1166 | EC_NNR_SEGMENTATIONFAILURE | Mobile subscriber was not reachable due to a network operator protocol error. |
1281 | EC_UA_USERSPECIFICREASON | Message was aborted by a network peer because of a network protocol error. |
1282 | EC_UA_USERRESOURCELIMITATION | Message was aborted by a network peer because of a network protocol error. |
1283 | EC_UA_RESOURCEUNAVAILABLE | Message was aborted by a network peer because of a network protocol error. |
1284 | EC_UA_APPLICATIONPROCEDURECANCELLATION | Message was aborted by a network peer because of a network protocol error. |
1536 | EC_PA_PROVIDERMALFUNCTION | Message was aborted due to other network protocol errors. |
1537 | EC_PA_SUPPORTINGDIALOGORTRANSACTIONREALEASED | Message was aborted due to other network protocol errors. |
1538 | EC_PA_RESSOURCELIMITATION | Message was aborted due to other network protocol errors. |
1539 | EC_PA_MAINTENANCEACTIVITY | Message was aborted due to other network protocol errors. |
1540 | EC_PA_VERSIONINCOMPATIBILITY | Message was aborted due to other network protocol errors. |
1541 | EC_PA_ABNORMALMAPDIALOG | Message was aborted due to other network protocol errors. |
1793 | EC_NC_RESPONSEREJECTEDBYPEER | Message was aborted due to other network protocol errors. |
1794 | EC_NC_ABNORMALEVENTRECEIVEDFROMPEER | Message was aborted due to other network protocol errors. |
1795 | EC_NC_MESSAGECANNOTBEDELIVEREDTOPEER | Message was aborted due to other network protocol errors. |
1796 | EC_NC_PROVIDEROUTOFINVOKE | Message was aborted due to other network protocol errors. |
2048 | EC_TIME_OUT | Time Out |
2049 | EC_IMSI_BLACKLISTED | IMSI blacklisted |
2050 | EC_DEST_ADDRESS_BLACKLISTED | The numbers were identified as blocklisted in the operator's DND (Do Not Disturb) database, provided by the operator, or the operator reverted the same error code. Resolving this error typically involves reviewing the blocklist status of the destination address, checking for any legitimate reasons for blocklisting, and taking appropriate actions to remove it. |
2051 | EC_INVALIDMSCADDRESS | Text blacklisted |
2052 | EC_BLACKLISTED_DESTINATIONADDRESS | The destination number has been blocklisted either at the operator's request or on your account |
2053 | EC_BLACKLISTED_SENDERADDRESS | The sender number has been blocklisted either at the operator's request or on your account |
4096 | EC_INVALID_PDU_FORMAT | Invalid PDU Format |
4097 | EC_NOTSUBMITTEDTOGMSC | Messages not passed to any operator |
4099 | EC_MONTHLY_LIMIT_REACHED | Your account monthly credit limit has been reached. Contact support for further assistance. |
4100 | EC_MESSAGE_CANCELED | The request was received, but has not been sent to the next instance within its validity period and has expired with the appropriate error code EC_MESSAGE_CANCELED, or the same error code was reverted from the operator. |
4101 | EC_VALIDITY_EXPIRED | Mobile operator could not contact the handset before reaching the expiry time. |
4102 | EC_NOTSUBMITTEDTOSMPPCHANNEL | Inbound SM can not be transferred via SMPP due to the lack of SMPP connectivity. |
4103 | EC_DESTINATION_FLOODING | As per the flooding filter rule, you can send 6 messages with the same content to the same destination in one hour, or you can send up to 20 messages with different content to the same destination in a period of one hour. |
4104 | EC_DESTINATION_TXT_FLOODING | Message is rejected due to the number of identical messages sent to a single number. |
4106 | EC_BLOCKED_BY_DLT | This error indicates that a message has been blocked by the DLT Provider due to regulatory compliance issues, sender registration, template registration, etc. |
4107 | EC_DLT_SCRUBBING_TIMEOUT | Timeout while performing DLT Scrubbing. |
4108 | EC_SENDER_BLOCKED_BY_DLT | The error typically indicates that the sender of a message has been blocked by the DLT Provider. This means that the sender has been restricted from sending messages due to non-compliance with regulations, insufficient registration, or other factors determined by the DLT Provider. |
4109 | EC_TELEMARKETER_BLOCKED_BY_DLT | Telemarketer blocked by DLT Scrubbing. |
4110 | EC_ENTITY_BLOCKED_BY_DLT | The error typically indicates that the principal entity ID of a message has been blocked by the DLT Provider. This means that the entity has been restricted from sending messages due to non-compliance with regulations, insufficient registration, or other factors determined by the DLT Provider. |
4111 | EC_TEMPLATE_BLOCKED_BY_DLT | The error typically indicates that the template or content of a message has been blocked by the DLT Provider. This means that the message template or content has been restricted from sending messages due to non-compliance with regulations, insufficient registration, or other factors determined by the DLT Provider. |
4112 | EC_ENTITY_NOT_FOUND | Indicates that the requested principal entity ID could not be found or located. This means that the DLT Provider was unable to locate the specific PE ID being referenced. It could be due to various reasons, such as an incorrect identifier, a non-existent entity, or a misconfiguration. |
4113 | EC_ENTITY_NOT_REGISTERED | No entry of entity on the platform. |
4114 | EC_ENTITY_INACTIVE | This error code indicates that the principal entity in question is inactive or disabled. This could be due to various reasons, such as principal entity ID suspension, temporary deactivation, or restrictions. Resolving this error typically check with DLT Provider. |
4115 | EC_ENTITY_BLACKLISTED | This error code indicates that the requested principal entity has been blocklisted. It means that the entity is restricted or prohibited on DLT Provider, such as violation of policies, non-compliance, or suspicious activity. |
4116 | EC_INVALID_ENTITY_ID | This error code suggests that the provided Principal entity ID is an invalid or wrong format or does not exist in the DLT Provider. It means that the principal entity ID is incorrect or unrecognized. Verifying the accuracy of the entity ID or resolving any issues related to the entity's DLT provider can help resolve this error. |
4117 | EC_ENTITY_ID_NOT_ALLOWED_FOR_TM | Principal entity is not allowed for the TM. |
4118 | EC_TELEMARKETER_NOT_REGISTERED | No entry of TMID on the platform. |
4119 | EC_TELEMARKETER_INACTIVE | Telemarketer is inactive on the platform. |
4120 | EC_TELEMARKETER_BLACKLISTED | Telemarketer is blocklisted on all platforms. |
4121 | EC_HEADER_NOT_FOUND | This error code signifies that the requested header/Sender ID information was not found. It means that the DLT Provider could not locate the required header in the given context or request. Review the request structure, and ensure the presence of the necessary headers. |
4122 | EC_HEADER_INACTIVE | This error code indicates that the requested header is inactive or disabled. It means that the header, typically used to send messages, is currently inactive. Activating the required header or checking for any configuration or permission-related issues on DLT Provider can help resolve this error. |
4123 | EC_HEADER_BLACKLISTED | This error code suggests that the requested header has been blocklisted, meaning it is restricted or prohibited from being used. It could be due to policy violations, non-compliance, or suspicious activity. |
4124 | EC_PEID_NOT_MATCHED_WITH_HEADER | This error code indicates that the provided PEID (Principal Entity ID) does not match the header/Sender ID information. It means that there is a mismatch between the specified PEID and the associated header in the request. Verifying the accuracy and alignment of the PEID and header on the DLT Provider can help resolve this error. |
4125 | EC_HEADER_IN_FREEPOOL | Header in free pool. |
4126 | EC_TEMPLATE_NOT_FOUND | This error code signifies that the requested template could not be found. It means that the DLT Provider was unable to locate the specified template, which is typically used for standardized message formats or content. Verifying the template's existence, and correct identifier, or troubleshooting any issues related to template retrieval can help address this error. |
4127 | EC_TEMPLATE_INACTIVE | This error code suggests that the requested template is inactive or disabled. It means that the template, which is typically used for predefined message structures, is currently not active on DLT Provider. Activating the required template or addressing any configuration or permission-related issues with DLT Provider can help resolve this error. |
4128 | EC_TEMPLATE_BLACKLISTED | This error code indicates that the requested template has been blocklisted, meaning it is restricted or prohibited from being used. It could be due to policy violations, non-compliance, or suspicious activity. |
4129 | EC_TEMPLATE_NOT_MATCHED | This error code suggests that the requested template does not match the provided content or message. It means that there is a mismatch between the specified template and the actual content being sent. Ensuring the alignment between the registered template and the actual content being sent can help resolve this error. |
4130 | EC_HEADER_NOT_REGISTERED_FOR_TEMPLATE | This error code signifies that the specified header is not registered or associated with the requested template. It means that the header being used does not align with the template requirements or associations. Verifying the registration and linkage between the header and template can help address this error. |
4131 | EC_TEMPLATE_VARIABLE_EXCEEDED_MAX_LENGTH | This error code indicates that a variable within the template exceeds the maximum allowed length. It means that variables used within the template exceed the defined character limit. Adjusting the character length can help resolve this error. |
4132 | EC_ERROR_IDENTIFYING_TEMPLATE | Error in identifying the template. |
4133 | EC_INVALID_TEMPLATE_ID | This error code suggests that the provided template ID is invalid or does not exist in the system. It means that the template ID/Content ID used to reference a specific template is incorrect or unrecognized. Verifying the accuracy of the template ID or troubleshooting any issues related to the template's existence can help address this error. |
4134 | EC_TEMPLATE_NOT_REGISTERED_TO_ENTITY | This error code signifies that the requested template is not registered or associated with the specified principal entity ID. It means the template being used does not link to the intended principal entity. Verifying the registration and association between the template and principal entity ID can help resolve this error. |
4135 | EC_PROMOTIONAL_TEMPLATE_USED_ON_OTHERS_HEADER | Promotional Template used on other/transaction header. |
4136 | EC_INVALID_TEMPLATE_TYPE | Invalid template type. |
4137 | EC_PREFERENCE_NOT_MATCHED | This error code indicates that the requested preference does not match the specified criteria on the end user number. It means that the preference being used does not align with the end user number. |
4138 | EC_INVALID_PROMO_TIME | This error code suggests that the provided promotional time is invalid or outside the allowed range (9 PM to 10 AM). It means that the specified promotional time period does not adhere to the defined constraints or rules. |
4139 | EC_SE_CATEGORY_BLOCK | This error code indicates that the requested category of service entity (SE) has been blocked. It means that the particular category or type of service entity is restricted or prohibited from being used. Resolving this error typically check the category of service entity or DND consent on a specific number. |
4140 | EC_CONSENT_FAILED | General error code for Consent. |
4141 | EC_SCRUBBING_FAILED | General error code in case of any exceptions. |
4142 | EC_TLV_PEID_NOT_FOUND | This error code suggests that the requested Principal Entity ID (PEID) within the TLV structure was not found. It means that the system or service could not locate the specified PEID within the TLV data. Verifying the correct usage and presence of the PEID within the TLV structure in the SMPP request can help resolve this error. |
4143 | EC_TLV_TMPID_NOT_FOUND | This error code signifies that the requested Template ID within the TLV structure was not found. It means that the system or service was unable to locate the specified Template ID within the TLV data. Verifying the correct usage and presence of the Template ID within the TLV structure in the SMPP request can help address this error. |
7000 | EC_R8_NO_ROUTE_FOUND | No valid messaging route available for processing |
7001 | EC_R8_DND | Number is in DND list |
7002 | EC_R8_MQ_RECOVERY_TIMEOUT | Failed to recover from MQ within timeout period |
7003 | EC_R8_INACTIVE_SUBSCRIBER | This error code indicates an inactive mobile subscriber |
7004 | EC_R8_FAILED_AS_DORMANT | Failed as Dormant |