Skip to content

Delivery Receipt

SMPP Delivery Receipt

After successful submit_sm you will receive message_id to track delivery status. You can either query delivery status by query_sm or wait or instant delivery receipt.

Example flow


Esme->SMSC: bind_receiver
SMSC->>Esme: bind_receiver_resp
Note right of Message Center: A message delivery \nhappens @ 📱
SMSC-->Message Center: Network Delivery
Message Center-->>SMSC: ACK
SMSC-->>Esme: deliver_sm
Esme->SMSC: deliver_sm_resp

Format of the deliver_sm

id:12345-9876 sub:001 dlvrd:000 submit date:20180721020159
done date:20180721020259 stat:ABC err:XYZ text:Sample
  • 12345-9876 is the corresponding message_id.
  • ABC is the message state.
State Description
DELIVRD Message is delivered to destination
EXPIRED Message validity period has expired
DELETED Message has been deleted
ACCEPTD Message is in accepted state
UNDELIV Message is undeliverable. See possible error codes.
UNKNOWN Message is in invalid state
REJECTD Message is in a rejected state

Delivery Error Codes

Code Label Description
1 ERR_UNKNOWN_SUBSCRIBER The message has been rejected because either the recipient does not exist or not registred in the operator’s network.
2 ERR_ABSENT_SUBSCRIBER The message is undeliverable because the subscriber is temporarily absent. ( Phone is switch off, they cannot belocated on the network.)
4 ERR_CALL_BARRED The Message is rejected due to the recipient has subscribed to Do Not Disturb service by the operator.
5 ERR_PORTABILITY The message was failed due to the recipient was unreachable in roaming conditions. (The recipient might be in foreign country or using another operator’s network)
7 ERR_DEVICE_BUSY The message has failed due to a temporary phone related error. ( SIMcard full,  phone busy, memory exceeded etc.)
8 ERR_NETWORK The message has failed due to a temporary condition in the operator network. ( This might be related to the SS7 layer, SMSC or gateway.)
9 ERR_ILLEGAL_RECIPIENT The message is undeliverable due to a blacklisted or permanently barred.
10 ERR_ILLEGAL_CONTENT The message rejected, due to the specific content is not permitted on the network.
11 ERR_ROUTING The message has failed due to a temporary condition in the operator network.( This might be related to the SS7 layer, SMSC or gateway.)
51 ERR_INVALID_RECIPIENT The recipient has not been set or it is empty, i.e. there must be valid recipients to send the message.
52 ERR_INVALID_SENDER The sender ID has not been set or it is empty. See sender ID FAQ page.
53 ERR_SENDER_POLICY Either you do not have STH license for the destination recipients' country or the sender ID has not been registred on your account. Please contact Support for further assistance.
54 ERR_MESSAGE_EMPTY The message has not been set or it is empty.
55 ERR_MESSAGE_TOO_LONG The Message has been rejected due to the total message length is more than 7 parts.
59 ERR_INVALID_UDH The Message has formatted incorrectly because of either an invalid ESM class parameter or an inaccurate amount of characters when using UDH ESM class:64. Please see our User Data Header / Concatenated SMS pages or contact our Support team for further assistance.
56 ERR_NETWORK_COVERAGE The recipient network is either out of our coverage or is not set up on your account. Please contact support for the coverage status.
60 ERR_DND_RECIPIENT The Message has been rejected due to the recipient has subscribed to Do Not Disturb services, disabling any service traffic to their number.
62 ERR_NOT_ENOUGH_CREDITS Your account is out of credits for further submission - please check out your account.
64 ERR_DESTINATION_BLACKLISTED The recipient number has been blacklisted either at the operator side or on your account. Please remove the blacklist on your account or contact Support for more information.
68 ERR_DEMO_ACCOUNT Your account has been set up for demo submission only for testing purposes - kindly upgrade your account to remove the limitation.
70 ERR_FLOODING_THROTTLE The Message has been rejected due to an anti-flooding mechanism. By default, a single recipient can only receive 10 varied messages and 3 identical messages per hour. Please contact our Support team for the further assistance.
71 ERR_SYSTEM_ERROR The request has been rejected due to an expected system error, please retry the submission or contact our technical support team for more details.
73 ERR_DUPLICATE_MESSAGE The request has been rejected due to a duplicate message ID specified in the submit request.
99 ERR_UNKNOWN The message has been confirmed as undelivered but no detailed information, related to the failure is known.