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:

StatusDescription
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.