View Sent SMS Report using Transaction ID Bulk SMS API Documnetation

View Sent SMS Report using Transaction ID

Fetch report based on Sent SMS Transaction ID

Application API URL:

https://www.smsgateway.center/library/api/self/SMSDlrTrans/

 

If you have huge record set, try to use lesser between dates for quicker report fetch.

 

Key Value Description
Login Credentials (Required Parameters)
Authenticate your API request using userId-password or apiKey. You should use either one to authenticate your login.
userId Your Registered Username The registered username parameter to be passed. You can use this if apiKey is not being used.
password Your password The password needs to be urlencoded if there are any special characters used in the password field. You can use this if apiKey is not being used.
apiKey Your unique apiKey apiKey needs to be sent as HTTP header when you are not using userId and password credentials. You can avail this from your user control panel and use instead of userId and password HTTP Request parameter. Please do not disclose this to anyone.
Additional Required Parameters
transId Unique Transaction ID An unique transaction id is generated for each transaction when you send SMS on our platform. You need to enter that transaction ID to fetch that particular transaction report.
format plain|json|xml Value for response format.

System default is plain. If you need responses in JSON or XML then you have to give value as JSON or XML.

Save this Page on your Favorite Social Media

Sample Request Code

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://www.smsgateway.center/library/api/self/SMSDlrTrans/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "userId=YourUsername&password=YourPassword&transId=53504db8-cc44-44d7-8db7-bc3ddda457c5&format=json",
  CURLOPT_HTTPHEADER => array(
    "cache-control: no-cache",
    "content-type: application/x-www-form-urlencoded"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://www.smsgateway.center/library/api/self/SMSDlrTrans/?userId=YourUsername&password=YourPassword&transId=53504db8-cc44-44d7-8db7-bc3ddda457c5&format=json",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_POSTFIELDS => "",
  CURLOPT_HTTPHEADER => array(
    "cache-control: no-cache",
    "content-type: application/x-www-form-urlencoded"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
var qs = require("querystring");
var http = require("http");

var options = {
  "method": "POST",
  "hostname": "www.smsgateway.center",
  "port": null,
  "path": "/library/api/self/SMSDlrTrans/",
  "headers": {
    "content-type": "application/x-www-form-urlencoded",
    "cache-control": "no-cache"
  }
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write(qs.stringify({ userId: 'YourUsername',
  password: 'YourPassword',
  transId: '53504db8-cc44-44d7-8db7-bc3ddda457c5',
  format: 'json' }));
req.end();
var qs = require("querystring");
var http = require("http");

var options = {
  "method": "GET",
  "hostname": "www.smsgateway.center",
  "port": null,
  "path": "/library/api/self/SMSDlrTrans/?userId=YourUsername&password=YourPassword&transId=53504db8-cc44-44d7-8db7-bc3ddda457c5&format=json",
  "headers": {
    "content-type": "application/x-www-form-urlencoded",
    "cache-control": "no-cache"
  }
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write(qs.stringify({}));
req.end();
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
RequestBody body = RequestBody.create(mediaType, "userId=YourUsername&password=YourPassword&transId=53504db8-cc44-44d7-8db7-bc3ddda457c5&format=json");
Request request = new Request.Builder()
  .url("https://www.smsgateway.center/library/api/self/SMSDlrTrans/")
  .post(body)
  .addHeader("content-type", "application/x-www-form-urlencoded")
  .addHeader("cache-control", "no-cache")
  .build();

Response response = client.newCall(request).execute();
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.smsgateway.center/library/api/self/SMSDlrTrans/?userId=YourUsername&password=YourPassword&transId=53504db8-cc44-44d7-8db7-bc3ddda457c5&format=json")
  .get()
  .addHeader("content-type", "application/x-www-form-urlencoded")
  .addHeader("cache-control", "no-cache")
  .build();

Response response = client.newCall(request).execute();

Response

{
    "status": "success",
    "statusCode": "900",
    "transactionId": "1d53848e-26d1-4852-ba4f-1c7fa18eda50",
    "reason": "Data Fetched.",
    "noofRecords": 1,
    "DLRReport": [
        {
            "Mobile": "91961xxxxxxx",
            "Sendername": "SGCSMS",
            "Received Time": "2017-10-08 18:08:28",
            "Status": "DELIVERED",
            "Cause": "Delivered",
            "Message": "test sms",
            "TransId": "53504db8-cc44-44d7-8db7-bc3ddda457c5",
            "msgId": "r6wvqxDL62VPkjy",
            "Length": "8",
            "Cost": "1",
            "Delivered Time": "2017-10-08 18:08:00"
        }
    ]
}
<?xml version="1.0" encoding="UTF-8"?>
<SmsGateway>
    <status>success</status>
    <statusCode>900</statusCode>
    <reason>Data Fetched.</reason>
    <transactionId>83f7a0ba-e41b-42bd-a418-0bc988208ce4</transactionId>
    <noofRecords>3/noofRecords>
    <DLRReport>
        <Mobile>91961xxxxxxx</Mobile>
        <Sendername>SGCSMS</Sendername>
        <ReceivedTime>2017-10-08 18:08:28</ReceivedTime>
        <Status>DELIVERED</Status>
        <Cause>Delivered</Cause>
        <SmsMessage></SmsMessage>
        <TransId>53504db8-cc44-44d7-8db7-bc3ddda457c5</TransId>
        <MessageId>r6wvqxDL62VPkjy</MessageId>
        <Length>8</Length>
        <Cost>1</Cost>
        <SmsMessage></SmsMessage>
        <SentTime>2017-10-08 18:08:00</SentTime>
    </DLRReport>
</SmsGateway>
Mobile, Sendername, Received Time,Status, Cause, Message, TransId, msgId, Length, Cost,Delivered Time
<br>91961xxxxxxx,SGCSMS,2017-10-08 18:08:28,DELIVERED,Delivered,test sms,53504db8-cc44-44d7-8db7-bc3ddda457c5,r6wvqxDL62VPkjy,8,1,2017-10-08 18:08:00