Sample code for 30+ languages & platforms
Delphi ActiveX

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 Delphi ActiveX Downloads

Delphi ActiveX
var
success: Integer;
messageId: WideString;
path: TChilkatStringBuilder;
region: WideString;
host: TChilkatStringBuilder;
signer: TChilkatAuthAws;
connection: TChilkatSocket;
rest: TChilkatRest;
sessionToken: WideString;
responseText: WideString;
response: TChilkatJsonObject;
i: Integer;
recipients: Integer;
j: Integer;
count: Integer;

begin
success := 0;

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

messageId := 'YOUR_SES_MESSAGE_ID';
path := TChilkatStringBuilder.Create(Self);
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 := TChilkatStringBuilder.Create(Self);
host.Append('email.');
host.Append(region);
host.Append('.amazonaws.com');

signer := TChilkatAuthAws.Create(Self);
//  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';

connection := TChilkatSocket.Create(Self);
connection.RequireSslCertVerify := 1;
success := connection.Connect(host.GetAsString(),443,1,10000);
if (success <> 1) then
  begin
    Memo1.Lines.Add(connection.LastErrorText);
    Exit;
  end;

rest := TChilkatRest.Create(Self);
success := rest.UseConnection(connection.ControlInterface,0);
if (success <> 1) then
  begin
    Memo1.Lines.Add(rest.LastErrorText);
    Exit;
  end;
success := rest.SetAuthAws(signer.ControlInterface);
if (success <> 1) then
  begin
    Memo1.Lines.Add(rest.LastErrorText);
    Exit;
  end;
//  For temporary AWS credentials, supply the session token from the same provider.
sessionToken := '';
if (sessionToken <> '') then
  begin
    rest.AddQueryParam('X-Amz-Security-Token',sessionToken);
  end;

responseText := rest.FullRequestNoBody('GET',path.GetAsString());
if (rest.LastMethodSuccess <> 1) then
  begin
    Memo1.Lines.Add(rest.LastErrorText);
    Exit;
  end;
if (rest.ResponseStatusCode = 404) then
  begin
    Memo1.Lines.Add('No insights found. Check the Region, message ID, and VDM coverage.');
    Exit;
  end;
if (rest.ResponseStatusCode <> 200) then
  begin
    Memo1.Lines.Add('SES returned HTTP ' + IntToStr(rest.ResponseStatusCode) + ' ' + responseText);
    Exit;
  end;
response := TChilkatJsonObject.Create(Self);
success := response.Load(responseText);
if (success <> 1) then
  begin
    Memo1.Lines.Add(response.LastErrorText);
    Exit;
  end;
i := 0;
recipients := response.SizeOfArray('Insights');
if (recipients < 1) then
  begin
    Memo1.Lines.Add('No recipient history is available yet.');
  end;
while (i < recipients) do
  begin
    response.I := i;
    Memo1.Lines.Add(response.StringOf('Insights[i].Destination'));
    j := 0;
    count := response.SizeOfArray('Insights[i].Events');
    while (j < count) do
      begin
        response.J := j;
        Memo1.Lines.Add(response.StringOf('Insights[i].Events[j].Timestamp') + ' ' + response.StringOf('Insights[i].Events[j].Type'));
        if (response.HasMember('Insights[i].Events[j].Details.Bounce.DiagnosticCode') = 1) then
          begin
            Memo1.Lines.Add(response.StringOf('Insights[i].Events[j].Details.Bounce.DiagnosticCode'));
          end;
        if (response.HasMember('Insights[i].Events[j].Details.Complaint.ComplaintFeedbackType') = 1) then
          begin
            Memo1.Lines.Add(response.StringOf('Insights[i].Events[j].Details.Complaint.ComplaintFeedbackType'));
          end;
        j := j + 1;
      end;

    i := i + 1;
  end;