1. Offline (Pulling – Not recommended)

   This is a pull method where a client requests a delivery report from the system by specifying a message id in the request. The URL below will return a delivery report for message id 288369252.

   • https://api.tililtech.com/sms/v3/getdlr?api_key=%3cAPI_KEY%3e&messageId=288369252

1. 1009;No dlr
2. 288369252;Success;1;DeliveredToTerminal;2020-05-13 08:47:03;00:00:06

Where:

This is the recommended method of getting delivery reports. A partner specifies a delivery reports callback URL from the portal. All delivery reports sent through an API will be pushed to the URL automatically.

Below is a PHP sample that can be hosted by the client to receive delivery report notifications. Note that the client has to implement the Business Logic for example:

• Updating a local sent message
• Storing the delivery report for later processing
• Generate a report or an alert for support monitoring

<?php
$data_json = file_get_contents('php://input');
$data_array = json_decode($data_json);

if (!$data_array) {
    die("0;error;unsupported data type");
}

$messageId = $data_array->messageId;
$dlrTime = $data_array->dlrTime;
$dlrStatus = $data_array->dlrStatus;
$dlrDesc = $data_array->dlrDesc;
$tat = $data_array->tat;
$network = $data_array->network;

// YOUR BUSINESS LOGIC

// END YOUR LOGIC: if all goes well echo 'OK' otherwise echo 'FAILED' for the system to retry
echo "OK;$messageId;$dlrDesc;$network";
?>

Delivery Codes and Descriptions