Delivery Receipts (DLRs)
On this page
How SMS delivery receipts work: requested per message, delivered to your inbound webhook as sms_dlr objects, with a link to the DLR error-code list.
Overview
DLRs are requested on a per-message basis. If you do not request a DLR, you will not have a record of the result of the transaction.
A Delivery Receipt (DLR) is an acknowledgement from a destination carrier network that a message was successfully accepted or rejected (and the reason the message was rejected). TSG Global supports DLRs on SMS and MMS if a customer has their requested delivery status flag set appropriately. The DLRs will be delivered to your inbound webhook/URI if requested.
DLR Example
Below is an example DLR:
{
"delivery_error_code": "000",
"delivery_status": "delivered",
"done_at": "2022-04-13T21:35:00",
"from": "14252437709",
"id": "a2692312-2050-4a50-9123-ca7b4cde0db7",
"inserted_at": "2022-04-13T21:35:22.401373",
"object": "sms_dlr",
"sms": {
"id": "a4c56a01-4daf-4ae1-9732-025b427add13"
},
"submitted_at": "2022-04-13T21:35:00",
"to": "18574914340",
"type": "inbound",
"updated_at": "2022-04-13T21:35:22.401373"
}
DLR Error Codes
A list of current DLR error codes can be found here:
https://support.tsgglobal.com/hc/en-us/articles/4643124175131-Common-DLR-Error-Codes