Skip to content

SMS delivery report codes (DLR)

For each transmitted SMS there is a delivery report (DLR). There are two ways to get these delivery reports:

  1. push http: We send the delivery reports via HTTP GET request or email (webhook) to your endpoint. See Event notifications for more information.
  2. pull http: you query the DLR using the endpoint GET /sms/{id} (id - SMS id) and check the parameter dlr_code.

Description of the delivery report status codes (property dlr_code):

Section titled “Description of the delivery report status codes (property dlr_code):”
Status codeDescription
0NONE: There is no delivery report available
1DELIVERY_OK: The message was successfully delivered
2DELIVERY_QUEUE: The message is scheduled for later sending
4DELIVERY_SUBMIT_ACK: The message is enroute
8DELIVERY_EXPIRED: The SMSC was unable to deliver the message in a specified amount of time. For instance when the phone was turned off
16DELIVERY_REJECTED: The message was rejected. The provider could have blocked phone numbers in this range