SESV2 / Client / list_suppressed_destinations

list_suppressed_destinations#

SESV2.Client.list_suppressed_destinations(**kwargs)#

Retrieves a list of email addresses that are on the suppression list for your account.

See also: AWS API Documentation

Request Syntax

response = client.list_suppressed_destinations(
    Reasons=[
        'BOUNCE'|'COMPLAINT',
    ],
    StartDate=datetime(2015, 1, 1),
    EndDate=datetime(2015, 1, 1),
    NextToken='string',
    PageSize=123
)
Parameters:

  • Reasons (list) –

    The factors that caused the email address to be added to .

    • (string) –

      The reason that the address was added to the suppression list for your account. The value can be one of the following:

      • COMPLAINT – Amazon SES added an email address to the suppression list for your account because a message sent to that address results in a complaint.

      • BOUNCE – Amazon SES added an email address to the suppression list for your account because a message sent to that address results in a hard bounce.

  • StartDate (datetime) – Used to filter the list of suppressed email destinations so that it only includes addresses that were added to the list after a specific date.

  • EndDate (datetime) – Used to filter the list of suppressed email destinations so that it only includes addresses that were added to the list before a specific date.

  • NextToken (string) – A token returned from a previous call to ListSuppressedDestinations to indicate the position in the list of suppressed email addresses.

  • PageSize (integer) – The number of results to show in a single call to ListSuppressedDestinations. If the number of results is larger than the number you specified in this parameter, then the response includes a NextToken element, which you can use to obtain additional results.

Return type:

dict

Returns:

Response Syntax

{
    'SuppressedDestinationSummaries': [
        {
            'EmailAddress': 'string',
            'Reason': 'BOUNCE'|'COMPLAINT',
            'LastUpdateTime': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    A list of suppressed email addresses.

    • SuppressedDestinationSummaries (list) –

      A list of summaries, each containing a summary for a suppressed email destination.

      • (dict) –

        A summary that describes the suppressed email address.

        • EmailAddress (string) –

          The email address that’s on the suppression list for your account.

        • Reason (string) –

          The reason that the address was added to the suppression list for your account.

        • LastUpdateTime (datetime) –

          The date and time when the suppressed destination was last updated, shown in Unix time format.

    • NextToken (string) –

      A token that indicates that there are additional email addresses on the suppression list for your account. To view additional suppressed addresses, issue another request to ListSuppressedDestinations, and pass this token in the NextToken parameter.

Exceptions

  • SESV2.Client.exceptions.BadRequestException

  • SESV2.Client.exceptions.TooManyRequestsException

  • SESV2.Client.exceptions.InvalidNextTokenException