# Validate email address

Validate a single email address for deliverability before sending.

Comprehensive validation checks:
- Syntax validation (RFC 5322 compliant)
- Domain existence verification (DNS lookup)
- MX record validation
- Advanced disposable email detection with continuously updated database
- Role account detection (support@, admin@, etc.)
- Intelligent typo suggestions for common domains

Business benefits:
- Reduce bounce rates by 60-80%
- Protect your sender reputation score
- Block temporary and disposable email addresses
- Identify role accounts to improve engagement
- Real-time validation with instant results

Enterprise reliability with 99.9% uptime SLA and global infrastructure.

Rate Limit: Consumes from your monthly validation quota (check /api/v1/address/validate/quota)

Endpoint: POST /api/v1/address/validate
Version: 1.0.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `email` (string, required)
    Email address to validate
    Example: "user@example.com"

## Response 200 fields (application/json):

  - `email` (string)
    Email address that was validated

  - `is_valid` (boolean)
    Whether the email address is valid and deliverable

  - `validation_checks` (object)
    Detailed validation check results

  - `validation_checks.syntax_valid` (boolean)
    Whether email syntax is valid (RFC 5322)

  - `validation_checks.domain_exists` (boolean)
    Whether the domain exists (DNS lookup)

  - `validation_checks.has_mx_records` (boolean)
    Whether domain has MX records configured

  - `validation_checks.is_disposable` (boolean)
    Whether domain is a disposable/temporary email service

  - `validation_checks.disposable_source` (string)
    Source that identified disposable domain (if applicable)
    Example: "multiple_sources"

  - `validation_checks.disposable_confidence` (integer)
    Confidence score for disposable detection (0-100)

  - `validation_checks.is_role_account` (boolean)
    Whether email is a role account (admin@, support@, etc.)

  - `validation_checks.is_free_provider` (boolean)
    Whether domain is a free email provider (Gmail, Yahoo, etc.)

  - `risk_level` (string)
    Overall risk assessment
    Enum: "low", "medium", "high"

  - `deliverability_score` (integer)
    Deliverability score (0-100, higher is better)

  - `suggestions` (array)
    Suggested corrections for typos
    Example: ["user@gmail.com"]

  - `reason` (string)
    Reason if email is invalid
    Example: "Disposable email service detected"

  - `usage` (object)
    Validation quota usage information

  - `usage.used` (integer)
    Validations used this period

  - `usage.limit` (integer)
    Total validation limit

  - `usage.remaining` (integer)
    Remaining validations

## Response 400 fields (application/json):

  - `error` (string)

  - `details` (object)

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message

## Response 429 fields (application/json):

  - `error` (string)

  - `usage` (object)