Sample code for 30+ languages & platforms
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.
JavaScript
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;
}