# Validate multiple emails

Validate up to 100 email addresses in a single request.
Each email is validated independently with full results returned.

Batch processing:
- Maximum 100 emails per request
- Each email validated independently
- Consumes 1 validation credit per email
- Returns individual results for each email

Use this for:
- List cleaning before campaigns
- Bulk validation of imported contacts
- Pre-send validation of subscriber lists

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

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

## Request fields (application/json):

  - `emails` (array, required)
    Array of email addresses to validate
    Example: ["user1@example.com","user2@gmail.com"]

## Response 200 fields (application/json):

  - `total` (integer)
    Total emails validated

  - `valid_count` (integer)
    Number of valid emails

  - `invalid_count` (integer)
    Number of invalid emails

  - `results` (array)

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

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

  - `results.validation_checks` (object)
    Detailed validation check results

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

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

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

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

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

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

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

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

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

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

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

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

  - `results.usage` (object)
    Validation quota usage information

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

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

  - `results.usage.remaining` (integer)
    Remaining validations

  - `usage` (object)

  - `usage.used` (integer)

  - `usage.limit` (integer)

  - `usage.remaining` (integer)

## Response 400 fields (application/json):

  - `error` (string)

## Response 401 fields (application/json):

  - `error` (string)
    Error code or message

## Response 429 fields (application/json):

  - `error` (string)