Sample code for 30+ languages & platforms
CkJava

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

Chilkat CkJava Downloads

CkJava
import com.chilkatsoft.*;

public class ChilkatExample {

  static {
    try {
        System.loadLibrary("chilkat");
    } catch (UnsatisfiedLinkError e) {
      System.err.println("Native code library failed to load.\n" + e);
      System.exit(1);
    }
  }

  public static void main(String argv[])
  {
    boolean success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    success = false;

    String messageId = "YOUR_SES_MESSAGE_ID";
    CkStringBuilder 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.
    String region = "us-west-2";
    CkStringBuilder host = new CkStringBuilder();
    host.Append("email.");
    host.Append(region);
    host.Append(".amazonaws.com");

    CkAuthAws signer = new CkAuthAws();
    //  Supply the credentials from your application's credential provider.
    signer.put_AccessKey("AWS_ACCESS_KEY_ID");
    signer.put_SecretKey("AWS_SECRET_ACCESS_KEY");
    signer.put_Region(region);
    signer.put_ServiceName("ses");

    CkSocket connection = new CkSocket();
    connection.put_RequireSslCertVerify(true);
    success = connection.Connect(host.getAsString(),443,true,10000);
    if (success != true) {
        System.out.println(connection.lastErrorText());
        return;
        }

    CkRest rest = new CkRest();
    success = rest.UseConnection(connection,false);
    if (success != true) {
        System.out.println(rest.lastErrorText());
        return;
        }

    success = rest.SetAuthAws(signer);
    if (success != true) {
        System.out.println(rest.lastErrorText());
        return;
        }

    //  For temporary AWS credentials, supply the session token from the same provider.
    String sessionToken = "";
    if (sessionToken != "") {
        rest.AddQueryParam("X-Amz-Security-Token",sessionToken);
        }

    String responseText = rest.fullRequestNoBody("GET",path.getAsString());
    if (rest.get_LastMethodSuccess() != true) {
        System.out.println(rest.lastErrorText());
        return;
        }

    if (rest.get_ResponseStatusCode() == 404) {
        System.out.println("No insights found. Check the Region, message ID, and VDM coverage.");
        return;
        }

    if (rest.get_ResponseStatusCode() != 200) {
        System.out.println("SES returned HTTP " + rest.get_ResponseStatusCode() + " " + responseText);
        return;
        }

    CkJsonObject response = new CkJsonObject();
    success = response.Load(responseText);
    if (success != true) {
        System.out.println(response.lastErrorText());
        return;
        }

    int i = 0;
    int recipients = response.SizeOfArray("Insights");
    if (recipients < 1) {
        System.out.println("No recipient history is available yet.");
        }

    while ((i < recipients)) {
        response.put_I(i);
        System.out.println(response.stringOf("Insights[i].Destination"));
        int j = 0;
        int count = response.SizeOfArray("Insights[i].Events");
        while ((j < count)) {
            response.put_J(j);
            System.out.println(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) {
                System.out.println(response.stringOf("Insights[i].Events[j].Details.Bounce.DiagnosticCode"));
                }

            if (response.HasMember("Insights[i].Events[j].Details.Complaint.ComplaintFeedbackType") == true) {
                System.out.println(response.stringOf("Insights[i].Events[j].Details.Complaint.ComplaintFeedbackType"));
                }

            j = j+1;
            }

        i = i+1;
        }
  }
}