SES / Client / get_send_statistics

get_send_statistics#

SES.Client.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.

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': {
        '...': '...',
    },
}