Docs/Bulk Verification

Bulk Verification

Upload a CSV of email addresses and get results for your entire list.

Overview

Bulk verification lets you verify thousands of email addresses in a single job. Upload a CSV file via the dashboard or API, and download the results when the job completes.

â„šī¸
Bulk verification is currently available via the dashboard. Full API endpoints for programmatic bulk uploads are coming soon.

Uploading via Dashboard

  1. Log in to verimails.com/dashboard
  2. Click Bulk Verify in the sidebar
  3. Upload your CSV file
  4. Wait for the job to complete (shown in your job list)
  5. Download the results CSV

CSV Format

Your CSV must have a column with email addresses. VeriMails auto-detects the email column, but for best results use a header named email:

csv
email
john@example.com
jane@company.com
info@business.io
sales@corp.net

Additional columns are preserved in the output and won't affect processing.

Supported formats

Output format

The results file is a CSV with all original columns plus new verification columns:

Added ColumnDescription
vm_statusVerification result: valid, invalid, risky, unknown, disposable
vm_safe_to_sendBoolean: true or false
vm_mx_foundMX records exist for domain
vm_is_catchallDomain accepts all email
vm_catchall_score0–100 deliverability score (catch-all domains only)
vm_is_disposableDisposable/temporary email provider
vm_is_role_accountRole-based address (info@, admin@, etc.)

Checking job status

In the dashboard, your job list shows real-time progress. Jobs typically complete at 5,000–10,000 verifications per minute depending on server load.

Webhook notifications

Webhook support for bulk job completion is coming soon. See Webhooks →

💡
Tip: For real-time list building, use the Single Verification API to verify addresses as you collect them. Bulk verification is best for cleaning existing lists.