SMS Delivery Report
SMS Delivery Report for SMSGatewayCenter APIs
Introduction to SMSGatewayCenter APIs
Welcome to SMSGatewayCenter’s API documentation hub! This guide helps you retrieve SMS delivery reports using our powerful SMS Delivery Report API, part of our messaging suite including SMS API for bulk messaging, WhatsApp Business API for customer engagement, Voice Call API for automated alerts, and Two-Way SMS API for interactive communication. Our API supports POST and GET methods over HTTP, offering delivery status in JSON or XML formats. Ideal for developers in India, start integrating with our SMS gateway at unify.smsgateway.center/signup/!
Get SMS delivery reports to monitor message statuses like delivered, failed, or pending, formatted in JSON or XML. This endpoint enhances your bulk SMS campaigns with real-time insights and Unicode support, perfect for tracking campaign performance.
API Endpoint
https://unify.smsgateway.center/SMSApi/report/status
| Key | Value | Description |
|---|---|---|
| Login Credentials (Required) | ||
| Authenticate your API request using userid-password or apiKey—choose one method. | ||
| userid | Your Registered Username | Your registered username; use if apiKey isn’t provided. Signup for User ID |
| password | Your Password | URL-encoded password (for special characters); use if apiKey isn’t provided. Signup for API Key |
| Header (optional) Parameters | ||
| apiKey | Your unique apiKey | apiKey needs to be sent as HTTP header when you are not using userid-password method. You can avail this from your user control panel and use instead of userid-password HTTP Request parameter. Please do not disclose this to anyone. |
| Required Parameters | ||
| method | getDlr | Enter method as getDlr. |
| fromdate | From Date | Enter from date. Date format should be YYYY-MM-DD |
| todate | To Date | Enter to date. Date format should be YYYY-MM-DD |
| pageLimit | integer | Number of records to fetch per call |
| Optional Parameters | ||
| mobileNo | Mobile number | Filter by number |
| uuId | Transaction ID | Filter by UUID |
| startCursor | Cursor start point | Add cursor point to get further records. |
| output | plain|json|plain | Value for response format.System default is plain. If you need responses in json or plain then you have to give value as json or plain. |
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://unify.smsgateway.center/SMSApi/report/status?userid=YourUsername&password=YourPassword&method=getDlr&fromdate=FROMDATE&todate=TODATE&pageLimit=2&mobile=OPTIONALMOBILEFILTER&output=json',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => array(
'Cookie: SERVERID=webC1'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
{
"apiName":"report",
"action":"status",
"status":"success",
"msg":"success",
"code":200,
"data":{
"cursors":{
"next":"43d68",
"start":"43493"
},
"pages":{
"current":1,
"last":9
},
"records":[
{
"senderName":"SMSGAT",
"flashMsg":false,
"msgType":"text",
"cost":1,
"submitTime":1698925939238,
"deliveryTime":1698925939000,
"msgId":"gECiX5iEcU3teJk",
"mobileNo":9188xxxxxxxxxx,
"text":"OTP: {#var#}, please use this OTP to register to your SMSGAT account. - SMSGAT",
"uuId":"379402422343452698",
"globalErrorCode":58,
"cursorId":275603
},
{
"senderName":"SMSGAT",
"flashMsg":false,
"msgType":"text",
"cost":1,
"submitTime":1698984901875,
"deliveryTime":1698984901875,
"msgId":"o7547NJXkjuZMJo",
"mobileNo":9188xxxxxxxxxx,
"text":"Hello World",
"uuId":"9222956729180964266",
"globalErrorCode":18,
"cursorId":277864
}
],
"counts":{
"total":17,
"current":2
}
}
}
Unlock Real-Time Messaging – Integrate Today!
Try Our API in a Sandbox Environment Before Going Live!
Join Thousands of Developers – Try Our API Now!
Get in touchSign upTestimonials
Why do Great Businesses Trust SMS Gateway Center?