get_send_statistics

get_send_statistics()

Provides sending statistics for the current AWS Region. The result is a list of data points, representing the last two weeks of sending activity. Each data point in the list contains statistics for a 15-minute period of time.

You can execute this operation no more than once per second.

See also: AWS API Documentation

Request Syntax

response = client.get_send_statistics()
Return type
dict
Returns
Response Syntax
{
    'SendDataPoints': [
        {
            'Timestamp': datetime(2015, 1, 1),
            'DeliveryAttempts': 123,
            'Bounces': 123,
            'Complaints': 123,
            'Rejects': 123
        },
    ]
}

Response Structure

  • (dict) --

    Represents a list of data points. This list contains aggregated data from the previous two weeks of your sending activity with Amazon SES.

    • SendDataPoints (list) --

      A list of data points, each of which represents 15 minutes of activity.

      • (dict) --

        Represents sending statistics data. Each SendDataPoint contains statistics for a 15-minute period of sending activity.

        • Timestamp (datetime) --

          Time of the data point.

        • DeliveryAttempts (integer) --

          Number of emails that have been sent.

        • Bounces (integer) --

          Number of emails that have bounced.

        • Complaints (integer) --

          Number of unwanted emails that were rejected by recipients.

        • Rejects (integer) --

          Number of emails rejected by Amazon SES.

Examples

The following example returns Amazon SES sending statistics:

response = client.get_send_statistics(
)

print(response)

Expected Output:

{
    'SendDataPoints': [
        {
            'Bounces': 0,
            'Complaints': 0,
            'DeliveryAttempts': 5,
            'Rejects': 0,
            'Timestamp': datetime(2016, 7, 13, 22, 43, 0, 2, 195, 0),
        },
        {
            'Bounces': 0,
            'Complaints': 0,
            'DeliveryAttempts': 3,
            'Rejects': 0,
            'Timestamp': datetime(2016, 7, 13, 23, 13, 0, 2, 195, 0),
        },
        {
            'Bounces': 0,
            'Complaints': 0,
            'DeliveryAttempts': 1,
            'Rejects': 0,
            'Timestamp': datetime(2016, 7, 13, 21, 13, 0, 2, 195, 0),
        },
    ],
    'ResponseMetadata': {
        '...': '...',
    },
}