Sample code for 30+ languages & platforms
CkPython

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

CkPython
import sys
import chilkat

success = False

#  Assumes Chilkat is unlocked. See Global Unlock Sample.
success = False

messageId = "YOUR_SES_MESSAGE_ID"
path = chilkat.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 = chilkat.CkStringBuilder()
host.Append("email.")
host.Append(region)
host.Append(".amazonaws.com")

signer = chilkat.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 = chilkat.CkSocket()
connection.put_RequireSslCertVerify(True)
success = connection.Connect(host.getAsString(),443,True,10000)
if (success != True):
    print(connection.lastErrorText())
    sys.exit()

rest = chilkat.CkRest()
success = rest.UseConnection(connection,False)
if (success != True):
    print(rest.lastErrorText())
    sys.exit()

success = rest.SetAuthAws(signer)
if (success != True):
    print(rest.lastErrorText())
    sys.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())
    sys.exit()

if (rest.get_ResponseStatusCode() == 404):
    print("No insights found. Check the Region, message ID, and VDM coverage.")
    sys.exit()

if (rest.get_ResponseStatusCode() != 200):
    print("SES returned HTTP " + str(rest.get_ResponseStatusCode()) + " " + responseText)
    sys.exit()

response = chilkat.CkJsonObject()
success = response.Load(responseText)
if (success != True):
    print(response.lastErrorText())
    sys.exit()

i = 0
recipients = response.SizeOfArray("Insights")
if (recipients < 1):
    print("No recipient history is available yet.")

while (i < recipients) :
    response.put_I(i)
    print(response.stringOf("Insights[i].Destination"))
    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"))
        if (response.HasMember("Insights[i].Events[j].Details.Bounce.DiagnosticCode") == True):
            print(response.stringOf("Insights[i].Events[j].Details.Bounce.DiagnosticCode"))

        if (response.HasMember("Insights[i].Events[j].Details.Complaint.ComplaintFeedbackType") == True):
            print(response.stringOf("Insights[i].Events[j].Details.Complaint.ComplaintFeedbackType"))

        j = j + 1

    i = i + 1