SESV2 / Client / get_email_address_insights

get_email_address_insights¶

SESV2.Client.get_email_address_insights(**kwargs)¶

Provides validation insights about a specific email address, including syntax validation, DNS record checks, mailbox existence, and other deliverability factors.

Request Syntax

response = client.get_email_address_insights(
    EmailAddress='string'
)

Parameters:

EmailAddress (string) –

[REQUIRED]

The email address to analyze for validation insights.

Return type:

dict

Returns:

Response Syntax

{
    'MailboxValidation': {
        'IsValid': {
            'ConfidenceVerdict': 'LOW'|'MEDIUM'|'HIGH'
        },
        'Evaluations': {
            'HasValidSyntax': {
                'ConfidenceVerdict': 'LOW'|'MEDIUM'|'HIGH'
            },
            'HasValidDnsRecords': {
                'ConfidenceVerdict': 'LOW'|'MEDIUM'|'HIGH'
            },
            'MailboxExists': {
                'ConfidenceVerdict': 'LOW'|'MEDIUM'|'HIGH'
            },
            'IsRoleAddress': {
                'ConfidenceVerdict': 'LOW'|'MEDIUM'|'HIGH'
            },
            'IsDisposable': {
                'ConfidenceVerdict': 'LOW'|'MEDIUM'|'HIGH'
            },
            'IsRandomInput': {
                'ConfidenceVerdict': 'LOW'|'MEDIUM'|'HIGH'
            }
        }
    }
}

Response Structure

(dict) –

Validation insights about an email address.
- MailboxValidation (dict) –
  
  Detailed validation results for the email address.
  - IsValid (dict) –
    
    Overall validity assessment with a conﬁdence verdict.
    - ConfidenceVerdict (string) –
      
      The confidence level of the validation verdict.
  - Evaluations (dict) –
    
    Specific validation checks performed on the email address.
    - HasValidSyntax (dict) –
      
      Checks that the email address follows proper RFC standards and contains valid characters in the correct format.
      - ConfidenceVerdict (string) –
        
        The confidence level of the validation verdict.
    - HasValidDnsRecords (dict) –
      
      Checks that the domain exists, has valid DNS records, and is conﬁgured to receive email.
      - ConfidenceVerdict (string) –
        
        The confidence level of the validation verdict.
    - MailboxExists (dict) –
      
      Checks that the mailbox exists and can receive messages without actually sending an email.
      - ConfidenceVerdict (string) –
        
        The confidence level of the validation verdict.
    - IsRoleAddress (dict) –
      
      Identiﬁes role-based addresses (such as admin@, support@, or info@) that may have lower engagement rates.
      - ConfidenceVerdict (string) –
        
        The confidence level of the validation verdict.
    - IsDisposable (dict) –
      
      Checks disposable or temporary email addresses that could negatively impact your sender reputation.
      - ConfidenceVerdict (string) –
        
        The confidence level of the validation verdict.
    - IsRandomInput (dict) –
      
      Checks if the input appears to be random text.
      - ConfidenceVerdict (string) –
        
        The confidence level of the validation verdict.

Exceptions

SESV2.Client.exceptions.TooManyRequestsException
SESV2.Client.exceptions.BadRequestException