Docs

Bulk validation: upload a CSV and download cleaner results.

Use bulk CSV jobs to validate large lists, track progress, receive webhooks, and export enriched recipient risk data.

CSV job lifecycle

Bulk jobs are designed for repeatable list hygiene. Upload a CSV with an email column, poll job status, then download enriched results when processing completes.

  • Upload a CSV with an email column.
  • Track total, processed, valid, invalid, risky, catch-all, and unknown counts.
  • Download an enriched CSV for segmentation and suppression decisions.

Recommended output workflow

Do not simply delete every non-valid address. Use the result categories to make a sending policy that matches your risk tolerance.

Suppress invalid

Remove hard failures and malformed addresses before sending.

Segment risky

Catch-all and role addresses can be kept separate for lower-volume or manual review workflows.

Retry unknown

Temporary SMTP blocks, greylists, or provider throttles can make a later result more reliable.

Automation options

Bulk validation can be driven through the API with optional webhook URLs for completion events. That makes it fit CRM imports, scheduled hygiene, and agency reporting.

  • Use /api/v1/validate/bulk for uploads.
  • Poll /api/v1/bulk/{job_id}.
  • Download /api/v1/bulk/{job_id}/download when complete.