Sample code for 30+ languages & platforms
C++

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 C++ Downloads

C++
#include <CkStringBuilder.h>
#include <CkAuthAws.h>
#include <CkSocket.h>
#include <CkRest.h>
#include <CkJsonObject.h>

void ChilkatSample(void)
    {
    bool success = false;

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

    const char *messageId = "YOUR_SES_MESSAGE_ID";
    CkStringBuilder path;
    path.Append("/v2/email/insights/");
    path.Append(messageId);
    path.Append("/");
    //  Use the same AWS Region for the identity, endpoint, and Signature Version 4.
    const char *region = "us-west-2";
    CkStringBuilder host;
    host.Append("email.");
    host.Append(region);
    host.Append(".amazonaws.com");

    CkAuthAws signer;
    //  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;
    connection.put_RequireSslCertVerify(true);
    success = connection.Connect(host.getAsString(),443,true,10000);
    if (success != true) {
        std::cout << connection.lastErrorText() << "\r\n";
        return;
    }

    CkRest rest;
    success = rest.UseConnection(connection,false);
    if (success != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    success = rest.SetAuthAws(signer);
    if (success != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

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

    const char *responseText = rest.fullRequestNoBody("GET",path.getAsString());
    if (rest.get_LastMethodSuccess() != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    if (rest.get_ResponseStatusCode() == 404) {
        std::cout << "No insights found. Check the Region, message ID, and VDM coverage." << "\r\n";
        return;
    }

    if (rest.get_ResponseStatusCode() != 200) {
        std::cout << "SES returned HTTP " << rest.get_ResponseStatusCode() << " " << responseText << "\r\n";
        return;
    }

    CkJsonObject response;
    success = response.Load(responseText);
    if (success != true) {
        std::cout << response.lastErrorText() << "\r\n";
        return;
    }

    int i = 0;
    int recipients = response.SizeOfArray("Insights");
    if (recipients < 1) {
        std::cout << "No recipient history is available yet." << "\r\n";
    }

    while ((i < recipients)) {
        response.put_I(i);
        std::cout << response.stringOf("Insights[i].Destination") << "\r\n";
        int j = 0;
        int count = response.SizeOfArray("Insights[i].Events");
        while ((j < count)) {
            response.put_J(j);
            std::cout << response.stringOf("Insights[i].Events[j].Timestamp") << " " << response.stringOf("Insights[i].Events[j].Type") << "\r\n";
            if (response.HasMember("Insights[i].Events[j].Details.Bounce.DiagnosticCode") == true) {
                std::cout << response.stringOf("Insights[i].Events[j].Details.Bounce.DiagnosticCode") << "\r\n";
            }

            if (response.HasMember("Insights[i].Events[j].Details.Complaint.ComplaintFeedbackType") == true) {
                std::cout << response.stringOf("Insights[i].Events[j].Details.Complaint.ComplaintFeedbackType") << "\r\n";
            }

            j = j + 1;
        }

        i = i + 1;
    }
    }