SMS Status Codes- HTTP API (On Submission)
When we receive an API call for sending SMS one of the following status code is attached at the application level.
The common status codes received while using the API are:
| Status | Description |
| AWAITED-DLR | Mobile number has been accepted and submitted to the operator. Awaiting delivery report from the operator |
| INVALID-NUM | In case any invalid number present along with the valid numbers. |
SMS Status Codes-XML/JSON API (On Submission)
There could be one or more nodes in an XML API, each of those nodes can have a different status code on submission. The common status codes received while using the API are:
Status | Description |
AWAITED-DLR | Mobile number has been accepted and submitted to the operator.Awaiting delivery report from the operator |
DNDNUMB | Mobile number is DND. |
OPTOUT-REJ | Opt out from subscription. |
INVALID-NUM | In case any invalid number present along with the valid numbers. |
SENDER-ID-NOT-FOUND | In case the sender ID given in any one of the nodes is not available |
INV-TEMPLATE- MATCH | In case the message given in any one of the nodes does not match the template approved for the sender ID in the same node |
MAX-LENGTH | In case the message given in any one of the nodes exceeds the maximum of 1000 characters |
SMS Status Codes (Operator Level)
On submission of a message to any operator, we associate one of the following status codes to every SMS to track the status. The common status codes received while using any API are as follows:
Status | Description |
NO-CREDITS | Insufficient credits. |
SERIES-BLOCK | Mobile number series blocked. |
INV-NUMBER | Invalid number. |
SERVER-ERR | Server error |
SPAM | Spam SMS |
SNDRID-NOT-ALLOTED | Sender ID not allocated. |
BLACKLIST | Blacklisted number |
TEMPLATE-NOT-FOUND | Template not mapped. |
INV-TEMPLATE-MATCH | Template not matching approved text. |
SENDER-ID-NOT-FOUND | Sender ID not found. |
DNDNUMB | DND registered number. |
NOT-OPTIN | Not subscribed for opt-in group. |
TIME-OUT-PROM | Time out for promotional SMS. |
DELIVRD | SMS successfully delivered. |
INVALID-SUB | Number does not exist. / Failed to locate the number in HLR database. |
ABSENT-SUB | Telecom services not providing service for the particular number. / Mobile Subscriber not reachable. |
HANDSET-ERR | Problem with Handset or handset failed to get the complete message. / Handset doesn’t support the incoming messages. |
BARRED | End user has enabled message barring system. / Subscriber only accepts messages from Closed User Group [CUG]. |
NET-ERR | Subscriber’s operator not supported. / Gateway mobile switching error. |
MEMEXEC | Handset memory full. |
FAILED | SMS expired due to roaming limitation. / Failed to process the message at operator level. |
MOB-OFF | Mobile handset in switched off mode. |
HANDSET-BUSY | Subscriber is in busy condition. |
SERIES-BLK | Series blocked by the operator. |
EXPIRED | SMS expired after multiple re-try. |
REJECTED | SMS Rejected as the number is blacklisted by operator. |
OUTPUT-REJ | Unsubscribed from the group. |
REJECTED-MULTIPART | Validation fail [SMS over 160 characters] |
UNDELIV | Failed due to network errors. |
NO-DLR-OPTR | In case operator has not acknowledged on status report of the SMS. |
| TL-NT-MTCHD | The submitted template does not match with the template registered with on DLT Portal |
| SDR-TL-MSMAT | The message template is not registered with the SenderID through which it was sent. |
| TL-NT-FOUND | The template that was sent is not found/registered. |
| TL-LMT-EXCED | The variables used in the template has exceeded maximum allowed length |
| TL-BLKLST | The sent template is black-listed at the DLT portal level |
| TL-INACTIVE | The sent template is inactive/not approved at DLT portal level |