Returns the current status and progress of a bulk CSV validation job.
Use this endpoint to poll for job completion. The percentComplete field indicates progress from 0 to 100.
Once the status is completed, use the download endpoint to retrieve the results.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Returns the current status and progress of a bulk CSV validation job.
Poll this endpoint periodically to track progress. The percentComplete field shows how far along the job is (0–100). The statistics field is null while processing and is populated with a full breakdown of results once the job completes.
Once status is completed, use the Download CSV Job Results endpoint to retrieve your results file.
Job Statuses
| Status | Description |
|---|---|
awaiting_upload | Job created, waiting for CSV file upload |
processing | CSV uploaded and emails are being validated |
completed | All emails validated — results ready for download |
failed | An error occurred (e.g., invalid CSV format, file exceeds 100 MB) |
expired | The CSV file was not uploaded before the upload URL expired |
Statistics
Once the job completes, the statistics object contains counts of validation results grouped by Allegrow status:
safe— Valid emails, safe to sendblock_bounce_risk— Invalid emails, likely to bouncedead_email— Invalid accounts with catch-all setupdo_not_mail_abuse— Valid emails with high spam report risksome_risk— Inconclusive results with identified risk factorsmore_time_required— Emails that needed additional processing time