Sign in

v1

latestOpenAPI 3.1.0Commercial License2026-07-132434129.1 KB
Advanced Email Validation API

Advanced email validation with SMTP verification

Performs comprehensive email validation including real-time SMTP verification, deliverability assessment, and advanced fraud detection.

Validation Process:

  1. Syntax Validation: RFC 5322/5321 compliance checking
  2. DNS Verification: MX record validation and domain reputation
  3. SMTP Testing: Real-time connection to mail server
  4. Deliverability Check: Inbox reachability assessment
  5. Security Analysis: Disposable email and role account detection
  6. Enhancement: Gravatar detection and domain suggestions

Advanced Features:

  • SMTP Verification: Real-time mail server connectivity testing
  • Inbox Analysis: Full inbox and catch-all domain detection
  • Provider Intelligence: Free vs. paid email provider identification
  • Security Screening: Role accounts and disposable email detection
  • User Experience: Domain typo suggestions and corrections

Response Includes:

  • Comprehensive reachability assessment (yes/no/unknown)
  • Detailed SMTP server analysis
  • Gravatar profile availability
  • Domain suggestion for typos
  • Advanced fraud prevention flags

Performance Note: This endpoint performs real-time SMTP checks which may take 500ms-2s

get/api/v1/email/advanced/{email}

Path parameters

emailstring required

Email address to validate with advanced analysis. Must be properly URL-encoded if containing special characters.

Supported Formats:

  • Standard emails: user@domain.com
  • Plus addressing: user+tag@domain.com
  • Internationalized domains: user@münchen.de
  • Complex local parts: "user.name"@domain.com

Size Limits: Maximum 320 characters (64 for local part + 255 for domain) Encoding: URL encoding required for special characters

Examples:

  • Business: john.doe@company.com
  • Free provider: user@gmail.com
  • International: user@exämple.com
  • Complex: "test+user"@sub.domain.co.uk

Performance: Advanced validation includes real-time SMTP checks which may take 500ms-2s

Response

Advanced email validation completed successfully with comprehensive analysis

emailstring required

The email address that was analyzed, returned in the original format provided.

reachable'yes' | 'no' | 'unknown' required

Overall reachability assessment. Values: 'yes', 'no', 'unknown'.

Reachability Levels:

  • yes: Email is deliverable and reachable
  • no: Email is not reachable or invalid
  • unknown: Unable to determine reachability status
suggestionstring required

Suggested correction for misspelled domains. Empty string if no suggestion available.

disposableboolean required

Indicates whether the email is from a disposable/temporary email service.

Disposable Email Detection:

  • Checks against extensive database of known disposable providers
  • Identifies temporary email services
  • Detects throwaway email patterns
role_accountboolean required

Indicates whether this is a role-based email account (admin@, support@, noreply@, etc.).

Role Account Types:

  • Administrative accounts (admin@, webmaster@)
  • Support accounts (support@, help@, info@)
  • No-reply accounts (noreply@, no-reply@)
  • Generic business accounts (sales@, contact@)
freeboolean required

Indicates whether the email domain is a free email provider (Gmail, Yahoo, Hotmail, etc.).

Free Email Providers Include:

  • Gmail, Yahoo Mail, Hotmail/Outlook
  • Regional free providers
  • Educational institution emails
  • Government email domains
has_mx_recordsboolean required

Indicates whether the domain has valid MX (Mail Exchange) records configured.

MX Record Verification:

  • Checks DNS for MX records
  • Validates mail server configuration
  • Essential for email deliverability

Example response

{
  "email": "test@yandex.ru",
  "reachable": "no",
  "syntax": {
    "username": "test",
    "domain": "yandex.ru",
    "valid": true
  },
  "smtp": {
    "host_exists": true,
    "full_inbox": false,
    "catch_all": false,
    "deliverable": false,
    "disabled": false
  },
  "gravatar": {
    "has_gravatar": false,
    "gravatar_url": ""
  },
  "suggestion": "",
  "disposable": false,
  "role_account": true,
  "free": true,
  "has_mx_records": true
}