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.
POST /api/bulk, poll GET /api/bulk/{job_id}, then download results from /api/bulk/{job_id}/download.Uploading via API
Send a multipart CSV upload with your API key. You can optionally pass email_column when the email field is not named email.
curl -X POST https://verimails.com/api/bulk \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@leads.csv" \
-F "name=May outreach" \
-F "email_column=Email Address"Uploading via Dashboard
- Log in to verimails.com/dashboard
- Click Bulk Verify in the sidebar
- Upload your CSV file
- Wait for the job to complete (shown in your job list)
- Download the results CSV
CSV Format
Your CSV must have a column with email addresses. VeriMails auto-detects common headers like email, Email Address, work_email, and business_email. Headerless one-column CSVs are also supported, but a clear email header is still best:
email
john@example.com
jane@company.com
info@business.io
sales@corp.netAdditional columns are preserved in the output and won't affect processing.
Supported formats
- CSV files with comma or semicolon separators
- UTF-8 encoding
- Up to 500,000 rows per job
- Max file size: 50MB
Output format
The full results file preserves the original CSV columns and appends a clear sendability column:
| Added Column | Description |
|---|---|
Safe to Send | Yes when the verified status is valid; No for invalid, catch-all, disposable, unknown, or risky results. |
Checking job status
In the dashboard, your job list shows real-time progress. Via API, poll GET /api/bulk/{job_id} until the job status is completed or failed.
Webhook notifications
Webhook support for bulk job completion is coming soon. See Webhooks â