SESV2 / Client / get_account

get_account#

SESV2.Client.get_account()#

Obtain information about the email-sending status and capabilities of your Amazon SES account in the current Amazon Web Services Region.

See also: AWS API Documentation

Request Syntax

response = client.get_account()
Return type:

dict

Returns:

Response Syntax

{
    'DedicatedIpAutoWarmupEnabled': True|False,
    'EnforcementStatus': 'string',
    'ProductionAccessEnabled': True|False,
    'SendQuota': {
        'Max24HourSend': 123.0,
        'MaxSendRate': 123.0,
        'SentLast24Hours': 123.0
    },
    'SendingEnabled': True|False,
    'SuppressionAttributes': {
        'SuppressedReasons': [
            'BOUNCE'|'COMPLAINT',
        ]
    },
    'Details': {
        'MailType': 'MARKETING'|'TRANSACTIONAL',
        'WebsiteURL': 'string',
        'ContactLanguage': 'EN'|'JA',
        'UseCaseDescription': 'string',
        'AdditionalContactEmailAddresses': [
            'string',
        ],
        'ReviewDetails': {
            'Status': 'PENDING'|'FAILED'|'GRANTED'|'DENIED',
            'CaseId': 'string'
        }
    },
    'VdmAttributes': {
        'VdmEnabled': 'ENABLED'|'DISABLED',
        'DashboardAttributes': {
            'EngagementMetrics': 'ENABLED'|'DISABLED'
        },
        'GuardianAttributes': {
            'OptimizedSharedDelivery': 'ENABLED'|'DISABLED'
        }
    }
}

Response Structure

  • (dict) –

    A list of details about the email-sending capabilities of your Amazon SES account in the current Amazon Web Services Region.

    • DedicatedIpAutoWarmupEnabled (boolean) –

      Indicates whether or not the automatic warm-up feature is enabled for dedicated IP addresses that are associated with your account.

    • EnforcementStatus (string) –

      The reputation status of your Amazon SES account. The status can be one of the following:

      • HEALTHY – There are no reputation-related issues that currently impact your account.

      • PROBATION – We’ve identified potential issues with your Amazon SES account. We’re placing your account under review while you work on correcting these issues.

      • SHUTDOWN – Your account’s ability to send email is currently paused because of an issue with the email sent from your account. When you correct the issue, you can contact us and request that your account’s ability to send email is resumed.

    • ProductionAccessEnabled (boolean) –

      Indicates whether or not your account has production access in the current Amazon Web Services Region.

      If the value is false, then your account is in the sandbox. When your account is in the sandbox, you can only send email to verified identities. Additionally, the maximum number of emails you can send in a 24-hour period (your sending quota) is 200, and the maximum number of emails you can send per second (your maximum sending rate) is 1.

      If the value is true, then your account has production access. When your account has production access, you can send email to any address. The sending quota and maximum sending rate for your account vary based on your specific use case.

    • SendQuota (dict) –

      An object that contains information about the per-day and per-second sending limits for your Amazon SES account in the current Amazon Web Services Region.

      • Max24HourSend (float) –

        The maximum number of emails that you can send in the current Amazon Web Services Region over a 24-hour period. A value of -1 signifies an unlimited quota. (This value is also referred to as your sending quota.)

      • MaxSendRate (float) –

        The maximum number of emails that you can send per second in the current Amazon Web Services Region. This value is also called your maximum sending rate or your maximum TPS (transactions per second) rate.

      • SentLast24Hours (float) –

        The number of emails sent from your Amazon SES account in the current Amazon Web Services Region over the past 24 hours.

    • SendingEnabled (boolean) –

      Indicates whether or not email sending is enabled for your Amazon SES account in the current Amazon Web Services Region.

    • SuppressionAttributes (dict) –

      An object that contains information about the email address suppression preferences for your account in the current Amazon Web Services Region.

      • SuppressedReasons (list) –

        A list that contains the reasons that email addresses will be automatically added to the suppression list for your account. This list can contain any or all of the following:

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

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

        • (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.

    • Details (dict) –

      An object that defines your account details.

      • MailType (string) –

        The type of email your account is sending. The mail type can be one of the following:

        • MARKETING – Most of your sending traffic is to keep your customers informed of your latest offering.

        • TRANSACTIONAL – Most of your sending traffic is to communicate during a transaction with a customer.

      • WebsiteURL (string) –

        The URL of your website. This information helps us better understand the type of content that you plan to send.

      • ContactLanguage (string) –

        The language you would prefer for the case. The contact language can be one of ENGLISH or JAPANESE.

      • UseCaseDescription (string) –

        A description of the types of email that you plan to send.

      • AdditionalContactEmailAddresses (list) –

        Additional email addresses where updates are sent about your account review process.

        • (string) –

      • ReviewDetails (dict) –

        Information about the review of the latest details you submitted.

        • Status (string) –

          The status of the latest review of your account. The status can be one of the following:

          • PENDING – We have received your appeal and are in the process of reviewing it.

          • GRANTED – Your appeal has been reviewed and your production access has been granted.

          • DENIED – Your appeal has been reviewed and your production access has been denied.

          • FAILED – An internal error occurred and we didn’t receive your appeal. You can submit your appeal again.

        • CaseId (string) –

          The associated support center case ID (if any).

    • VdmAttributes (dict) –

      The VDM attributes that apply to your Amazon SES account.

      • VdmEnabled (string) –

        Specifies the status of your VDM configuration. Can be one of the following:

        • ENABLED – Amazon SES enables VDM for your account.

        • DISABLED – Amazon SES disables VDM for your account.

      • DashboardAttributes (dict) –

        Specifies additional settings for your VDM configuration as applicable to the Dashboard.

        • EngagementMetrics (string) –

          Specifies the status of your VDM engagement metrics collection. Can be one of the following:

          • ENABLED – Amazon SES enables engagement metrics for your account.

          • DISABLED – Amazon SES disables engagement metrics for your account.

      • GuardianAttributes (dict) –

        Specifies additional settings for your VDM configuration as applicable to the Guardian.

        • OptimizedSharedDelivery (string) –

          Specifies the status of your VDM optimized shared delivery. Can be one of the following:

          • ENABLED – Amazon SES enables optimized shared delivery for your account.

          • DISABLED – Amazon SES disables optimized shared delivery for your account.

Exceptions

  • SESV2.Client.exceptions.TooManyRequestsException

  • SESV2.Client.exceptions.BadRequestException