JavaScript
JavaScript
Amazon SES v2: Look up delivery history for a message ID
See more Amazon SES Examples
Enable Virtual Deliverability Manager for the sending account. Use the SES MessageId from a recent eligible send to a real test mailbox in the same Region. Mailbox simulator sends are excluded from VDM. Events are grouped by destination. Timestamps in the REST response are Unix epoch seconds.
GetMessageInsights · VDM dashboard
Note
This example is intended for running within a Chilkat.Js embedded JavaScript engine. All Chilkat JavaScript examples require Chilkat
v11.4.0 or greater.
var success = false;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
success = false;
var messageId = "YOUR_SES_MESSAGE_ID";
var path = new CkStringBuilder();
path.Append("/v2/email/insights/");
path.Append(messageId);
path.Append("/");
// Use the same AWS Region for the identity, endpoint, and Signature Version 4.
var region = "us-west-2";
var host = new CkStringBuilder();
host.Append("email.");
host.Append(region);
host.Append(".amazonaws.com");
var signer = new CkAuthAws();
// Supply the credentials from your application's credential provider.
signer.AccessKey = "AWS_ACCESS_KEY_ID";
signer.SecretKey = "AWS_SECRET_ACCESS_KEY";
signer.Region = region;
signer.ServiceName = "ses";
var connection = new CkSocket();
connection.RequireSslCertVerify = true;
success = connection.Connect(host.GetAsString(),443,true,10000);
if (success !== true) {
console.log(connection.LastErrorText);
return;
}
var rest = new CkRest();
success = rest.UseConnection(connection,false);
if (success !== true) {
console.log(rest.LastErrorText);
return;
}
success = rest.SetAuthAws(signer);
if (success !== true) {
console.log(rest.LastErrorText);
return;
}
// For temporary AWS credentials, supply the session token from the same provider.
var sessionToken = "";
if (sessionToken !== "") {
rest.AddQueryParam("X-Amz-Security-Token",sessionToken);
}
var responseText = rest.FullRequestNoBody("GET",path.GetAsString());
if (rest.LastMethodSuccess !== true) {
console.log(rest.LastErrorText);
return;
}
if (rest.ResponseStatusCode == 404) {
console.log("No insights found. Check the Region, message ID, and VDM coverage.");
return;
}
if (rest.ResponseStatusCode !== 200) {
console.log("SES returned HTTP " + rest.ResponseStatusCode + " " + responseText);
return;
}
var response = new CkJsonObject();
success = response.Load(responseText);
if (success !== true) {
console.log(response.LastErrorText);
return;
}
var i = 0;
var recipients = response.SizeOfArray("Insights");
if (recipients < 1) {
console.log("No recipient history is available yet.");
}
while ((i < recipients)) {
response.I = i;
console.log(response.StringOf("Insights[i].Destination"));
var j = 0;
var count = response.SizeOfArray("Insights[i].Events");
while ((j < count)) {
response.J = j;
console.log(response.StringOf("Insights[i].Events[j].Timestamp") + " " + response.StringOf("Insights[i].Events[j].Type"));
if (response.HasMember("Insights[i].Events[j].Details.Bounce.DiagnosticCode") == true) {
console.log(response.StringOf("Insights[i].Events[j].Details.Bounce.DiagnosticCode"));
}
if (response.HasMember("Insights[i].Events[j].Details.Complaint.ComplaintFeedbackType") == true) {
console.log(response.StringOf("Insights[i].Events[j].Details.Complaint.ComplaintFeedbackType"));
}
j = j+1;
}
i = i+1;
}