Bulk Email Address Validation

Verify large batches of email addresses at once (up to 1,000 per request). Get detailed validity results for each address including status, flags, and suggested corrections.

Actions

verify

Validate a list of email addresses in bulk. The tool creates a verification job, polls for completion, and returns per-email results with summary statistics.

Required Fields:

• action — set to "verify"
• api_key — your API key for the email verification service
• emails — array of email addresses to verify (1 to 1,000)

Optional Fields:

• timeout — maximum seconds to wait for results (default: 30, range: 10–300). For large lists, increase this value.

Example:

{
  "action": "verify",
  "api_key": "your-api-key",
  "emails": [
    "alice@example.com",
    "bob@invalid-domain.xyz",
    "carol@gmail.com",
    "support@company.org"
  ],
  "timeout": 60
}

Response includes:

• job_id — unique identifier for the verification job
• status — job status (e.g., "complete")
• total_processed — number of emails processed
• results_summary — counts by category: valid, invalid, catchall, unknown, disposable, duplicate
• results — per-email array with email, result (validity status), flags, and suggested_correction

Result categories:

• valid — confirmed deliverable address
• invalid — undeliverable address (bad domain, mailbox does not exist, etc.)
• catchall — domain accepts all mail; individual address cannot be confirmed
• unknown — verification was inconclusive
• disposable — temporary/throwaway email address
• duplicate — address appeared more than once in the batch

Timeout behavior: If the job does not finish within the timeout window, the response returns the job_id and current status so you can reference it later.

Common Workflows

Clean a mailing list before a campaign

1. Collect all recipient addresses into an array.
2. Call verify with the list (split into batches of 1,000 if needed).
3. Remove addresses marked invalid or disposable.
4. Review catchall and unknown addresses for manual decision.

Validate sign-up imports

1. Export new user emails from your database.
2. Call verify to flag bad addresses.
3. Reach out to users with invalid emails to request corrections — check the suggested_correction field for typo fixes.

Important Notes

• Batch limit: maximum 1,000 emails per request. For larger lists, split into multiple calls.
• Timeout guidance: small lists (under 50) typically complete within 30 seconds. Larger lists may need 60–300 seconds. If a job times out, you receive a job_id to check later.
• Duplicates: duplicate emails in the same batch are flagged in the results summary.
• Rate / billing: each email in the batch counts as one verification unit.