Sign in

v1

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

Batch email validation from JSON array

Validates multiple email addresses provided as a JSON array with advanced SMTP verification.

Batch Processing Features:

  • Synchronous processing of up to 100 emails per request
  • All-or-nothing quota deduction (only charged after successful completion)
  • Comprehensive validation results for each email
  • Detailed statistics for the batch operation

Request Format:

  • JSON object containing an array of email addresses
  • Maximum 100 emails per batch request
  • Each email validated with full advanced features

Quota Management:

  • One quota unit deducted per email address
  • Quota deducted only after ALL validations complete successfully
  • No quota charged if batch processing fails

Performance:

  • Processing time: ~500ms-2s per email due to SMTP checks
  • Total batch time: 5-200 seconds depending on batch size

Use Cases:

  • Marketing list validation
  • User registration batch processing
  • Email list cleaning operations
  • Lead qualification workflows
post/api/v1/email/advanced/batch

Request body

emailsstring[] required

List of email addresses to validate. Maximum 100 emails per request.

Email Format Requirements:

  • Standard email format (user@domain.com)
  • Maximum 320 characters per email
  • Properly URL-encoded if containing special characters

Batch Processing:

  • All emails are processed synchronously
  • Results are returned in the same order as input
  • Quota is deducted only after successful completion of all validations

Example request

{
  "emails": [
    "user1@example.com",
    "user2@gmail.com",
    "user3@company.org"
  ]
}

Response

Batch validation completed successfully

resultsobject required

Map of email addresses to their validation results. The key is the original email address, and the value is the complete validation result.

totalProcessedinteger required

Total number of emails processed in this batch.

successfulValidationsinteger required

Number of emails that were successfully validated.

failedValidationsinteger required

Number of emails that failed validation (returned null from service).

Example response

{
  "results": {
    "user1@example.com": {
      "email": "user1@example.com",
      "reachable": "yes",
      "syntax": {
        "username": "user1",
        "domain": "example.com",
        "valid": true
      },
      "smtp": {
        "host_exists": true,
        "full_inbox": false,
        "catch_all": false,
        "deliverable": true,
        "disabled": false
      },
      "gravatar": {
        "has_gravatar": false,
        "gravatar_url": ""
      },
      "suggestion": "",
      "disposable": false,
      "role_account": false,
      "free": false,
      "has_mx_records": true
    },
    "user2@gmail.com": {
      "email": "user2@gmail.com",
      "reachable": "unknown",
      "syntax": {
        "username": "user2",
        "domain": "gmail.com",
        "valid": true
      },
      "smtp": null,
      "gravatar": null,
      "suggestion": "",
      "disposable": false,
      "role_account": false,
      "free": true,
      "has_mx_records": true
    }
  },
  "total_processed": 2,
  "successful_validations": 2,
  "failed_validations": 0
}