Sample code for 30+ languages & platforms
CkPhp

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

CkPhp
<?php

include("chilkat.php");

$success = false;

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

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

$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');

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

$rest = new CkRest();
$success = $rest->UseConnection($connection,false);
if ($success != true) {
    print $rest->lastErrorText() . "\n";
    exit;
}

$success = $rest->SetAuthAws($signer);
if ($success != true) {
    print $rest->lastErrorText() . "\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() != true) {
    print $rest->lastErrorText() . "\n";
    exit;
}

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

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

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

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

while (($i < $recipients)) {
    $response->put_I($i);
    print $response->stringOf('Insights[i].Destination') . "\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') . "\n";
        if ($response->HasMember('Insights[i].Events[j].Details.Bounce.DiagnosticCode') == true) {
            print $response->stringOf('Insights[i].Events[j].Details.Bounce.DiagnosticCode') . "\n";
        }

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

        $j = $j + 1;
    }

    $i = $i + 1;
}


?>