Receive DLRs
Overview
You can receive DLR messages via SMTP or HTTP webhook on the same URL as regular messages. The original message is referenced in the message_id
attribute.
DLR status codes
status code | Description |
---|---|
Deferred | The handset has retrieved the MMS header, but has not downloaded the full message from the mobile network. The handset may still download the message at a later time. |
Expired | The handset did not retrieve the message before the message expiration time. |
Forwarded | The message has been sent successfully to the mobile network. |
Indeterminate | The mobile network could not determine if the message was delivered correctly. |
Rejected | The message has been rejected by the MMS gateway or mobile network. |
Retrieved | The message was successfully delivered to the handset and the handset was configured to acknowledge the message with a delivery receipt. |
Unrecognised | The handset of the mobile subscriber does not recognize the message content. |
Webhook Format
All requests are made using the POST HTTP Verb to the specified endpoint.
The request will include the following headers:
NOTE: additional headers may be included that are not listed here.
Example payload:
Webhook Response
You must respond with a 2xx status code to acknowledge the DLR message.
If you respond with a 5xx status code the MMS system will retry delivery later with an exponential backoff, similar to MMS delivery.
3xx and 4xx status codes will be considered as a permanent failure and we won't attempt re-delivery
Last updated