Sign in

v1

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

Comprehensive email validation and analysis

Performs detailed validation and analysis of an email address for fraud prevention and data quality.

Validation Process:

  1. Syntax Validation: RFC 5322 compliance checking
  2. Domain Analysis: MX record verification and domain reputation
  3. Provider Detection: Identifies disposable, free, and role-based emails
  4. Security Checks: Typosquatting and suspicious pattern detection
  5. Deliverability Assessment: Real-time SMTP verification (optional)

Response Includes:

  • Detailed validation results with specific error reasons
  • Domain and username breakdown
  • Disposable email service detection
  • Syntax compliance status

Performance: Cached results for improved response times on repeated queries

get/api/v1/email/{email}

Path parameters

emailstring required

Email address to validate and analyze. 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
  • Quoted 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:

  • Simple: john.doe@company.com
  • Complex: "test user"@sub.domain.co.uk
  • International: user@exämple.com

Response

Email validation completed successfully with detailed analysis results

emailstring required

The email address that was analyzed, returned in normalized lowercase format.

Normalization Applied:

  • Converted to lowercase
  • Whitespace trimmed
  • Unicode normalization (NFC)
  • Punycode encoding for international domains

Note: The returned format may differ slightly from input due to normalization

is_disposableboolean required

Indicates whether the email address uses a disposable or temporary email service.

Disposable Email Characteristics:

  • Temporary email addresses that auto-expire
  • One-time use email services
  • Anonymous email generators
  • Throwaway email providers

Detection Method: Real-time lookup against 10,000+ known disposable domains Risk Level: High for fraud prevention use cases Update Frequency: Daily threat intelligence updates

has_mx_recordsboolean required

Whether the email domain has valid MX records in DNS. False when no records exist or DNS lookup fails.

Example response

{
  "email": "john.doe@company.com",
  "is_disposable": false,
  "syntax": {
    "domain": "company.com",
    "username": "john.doe",
    "is_valid": true,
    "error_reasons": []
  }
}