Message Status Consultation (DLR)

Endpoint: https://api.smsdev.com.br/v1/dlr

Method: POST, GET ou JSON

Description: This method is used to query the status of the message (DLR).

You must keep the id of the sending message (MT) to use in that method, or use the parameter refer passed in shipping.


Description of parameters

Name Type Standard Required Description
key text yes Account authentication key.
id array number yes Unique ID of the sending message (MT).

Was this article helpful to you?

			

{
	"key" : "XXXXXXXXXXXXXXXXXXXX",
	"id" : [9999999,888888,7777777]
}

				
			
		
			
				https://api.smsdev.com.br/v1/dlr?key=SUA_CHAVE_KEY&id=123456789
				
			
			
    

Copy and paste in the browser

			
curl --request GET \
  --url 'https://api.smsdev.com.br/v1/dlr?key=SUA_CHAVE_KEY&id=123456789'

		
			
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://api.smsdev.com.br/v1/dlr?key=SUA_CHAVE_KEY&id=123456789",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_SSL_VERIFYHOST => 0,
  CURLOPT_SSL_VERIFYPEER => 0,
));

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

curl_close($curl);

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

?>
	
		
			
HttpResponse<String> response = Unirest.get("https://api.smsdev.com.br/v1/dlr?key=SUA_CHAVE_KEY&id=123456789").asString();


		
			

	var http = require("http");

var options = {
			"method": "GET",
			"hostname": "api.smsdev.com.br",
			"port": null,
			"path": "/v1/dlr?key=SUA_CHAVE_KEY&id=123456789",
			"headers": {}
		};

		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.end();

	
		
The above method returns code in the pattern below
		
		{ 
   "situacao" : "OK",
   "codigo" : "1",
   "data_envio" : "21\/10\/2019 11:08:58",
   "operadora" : "OI",
   "descricao" : "RECEBIDA"
}
		
	
Return description
Name Description
situation “OK” - Successful submission
"ERROR" - Submission with error
code See error code table.
Shipping date Date of sending message dd / mm / yyyy hh24: mi: ss
operator Sending phone operator (MT).
description RECEIVED - Message delivered to the customer's device.
SENT - Message sent to operator.
ERROR - Message validation error.
QUEUE - Message awaiting processing.
CANCELED - Message canceled by the user.
BLACK LIST - Active recipient in the 'Black List' group.