Sample code for 30+ languages & platforms
CkPerl

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 CkPerl Downloads

CkPerl
use chilkat();

$success = 0;

#  Assumes Chilkat is unlocked. See Global Unlock Sample.
$success = 0;

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

$signer = chilkat::CkAuthAws->new();
#  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");

$connection = chilkat::CkSocket->new();
$connection->put_RequireSslCertVerify(1);
$success = $connection->Connect($host->getAsString(),443,1,10000);
if ($success != 1) {
    print $connection->lastErrorText() . "\r\n";
    exit;
}

$rest = chilkat::CkRest->new();
$success = $rest->UseConnection($connection,0);
if ($success != 1) {
    print $rest->lastErrorText() . "\r\n";
    exit;
}

$success = $rest->SetAuthAws($signer);
if ($success != 1) {
    print $rest->lastErrorText() . "\r\n";
    exit;
}

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

$responseText = $rest->fullRequestNoBody("GET",$path->getAsString());
if ($rest->get_LastMethodSuccess() != 1) {
    print $rest->lastErrorText() . "\r\n";
    exit;
}

if ($rest->get_ResponseStatusCode() == 404) {
    print "No insights found. Check the Region, message ID, and VDM coverage." . "\r\n";
    exit;
}

if ($rest->get_ResponseStatusCode() != 200) {
    print "SES returned HTTP " . $rest->get_ResponseStatusCode() . " " . $responseText . "\r\n";
    exit;
}

$response = chilkat::CkJsonObject->new();
$success = $response->Load($responseText);
if ($success != 1) {
    print $response->lastErrorText() . "\r\n";
    exit;
}

$i = 0;
$recipients = $response->SizeOfArray("Insights");
if ($recipients < 1) {
    print "No recipient history is available yet." . "\r\n";
}

while (($i < $recipients)) {
    $response->put_I($i);
    print $response->stringOf("Insights[i].Destination") . "\r\n";
    $j = 0;
    $count = $response->SizeOfArray("Insights[i].Events");
    while (($j < $count)) {
        $response->put_J($j);
        print $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") == 1) {
            print $response->stringOf("Insights[i].Events[j].Details.Bounce.DiagnosticCode") . "\r\n";
        }

        if ($response->HasMember("Insights[i].Events[j].Details.Complaint.ComplaintFeedbackType") == 1) {
            print $response->stringOf("Insights[i].Events[j].Details.Complaint.ComplaintFeedbackType") . "\r\n";
        }

        $j = $j + 1;
    }

    $i = $i + 1;
}