What is Nexmo's SMPP DLR format? – Knowledgebase

Format of the message_id :

- In the submit_sm_resp : message_id is represented in hexadecimal format.

- In the deliver_sm ( DLR) : message_id is represented in decimal format.

Tip: For Kannel users please use msg-id-type=0x01

Format of the deliver_sm ( DLR) :

"id:XXXXXXXXXX sub:001 dlvrd:000 submit date:YYMMDDHHMM done date:YYMMDDHHMM stat:ZZZZZZZ err:YYY text:none "

- XXXXXXXXXX is the corresponding message_id (in decimal).

- ZZZZZZZ is the message state:

Message 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
UNKNOWN	Message is in invalid state
REJECTD	Message is in a rejected state

The error codes list YYY below apply when message state is different from DELIVRD or ACCEPTD:

Error Code	Error label	Description
1	Unknown error	The message has beenconfirmed as undelivered but no detailed information related to the failure is known.
2	Absent Subscriber Temporary	The message is undeliverable because the subscriber is temporarily absent, e.g. their phone is switch off, they cannot belocated on the network.
3	Absent Subscriber Permanent	The message is undeliverable due to an incorrect / invalid /blacklisted / permanently barred MSISDN .
4	Call Barred by User	Message is rejected due to the barring of the MSISDN by the operator.
5	Portability error	The message was failed due to the ported combinations being unreachable
6	ANTI-SPAM error	The message fails or is rejected due to suspicion of SPAM on the operator network.
7	Handset is busy	The message has failed due to a temporary phone related error, e.g. SIMcard full, phone busy, memory exceeded etc.
8	Network error	The message has failed due to a temporary condition in the operator network. This could be related to the SS7 layer, SMSC or gateway.
9	Illegal number	The message is undeliverable due to a blacklisted /permanently barred MSISDN .
10	Invalid message	Used when this specific content is not permitted on the network
11	Unroutable message	The message has failed due to a temporary condition in the operator network. This could be related to the SS7 layer, SMSC or gateway.
99	General error	The message has failed due to a temporary condition in the gateway.