Bulk email list verification
To clean a list, batch processing analyses a file of addresses asynchronously, then returns it line by line, enriched with its status. It applies exactly the same checks and the same billing rules as real-time validation. An audit mode measures the quality of a list without spending a credit.
The report delivered with every job
At the end of a job, the file comes back enriched line by line, together with a summary report: a verdict on the list, the breakdown of statuses, the signals detected, the profile of the list and the actions to take before sending. The report downloads as PDF, the file as CSV or XLSX.
Validation report contacts-newsletter.csv
- CSV
- XLSX
86%deliverable
Usable list
Good quality. A few optimisations are still possible.
- Deliverable
valid17,200 that is 86% of the file - Risky
risky1,200 that is 6% of the file - Invalid
invalid1,000 that is 5% of the file - Unknown
unknown600 that is 3% of the file, not billed
Signals detected
- Role accounts 1,400
- Disposable domains 240
- Typos corrected 180
- Trap domains (typosquatting) 40
List profile
- Business addresses: 62%
- Consumer providers: 38%
19,400 credits charged and 600 refunded: unknown addresses are not billed.
Recommended actions
- Remove the 1,000 invalid addresses before any send
- Set aside the 40 addresses on a trap domain
- Re-validate the 600 addresses with an unknown status
- Send to the 17,200 deliverable addresses
What a file can contain
An imported file can hold up to five hundred thousand lines, at most fifteen megabytes. The formats accepted for import are CSV and plain text. The result can also be retrieved in spreadsheet format, ready to use.
| Constraint | Value |
|---|---|
| Maximum lines processed | 500,000 lines |
| Size of the imported file | 15 megabytes |
| Formats accepted for import | CSV, TXT |
| Formats available for export | CSV, XLSX, PDF |
A batch job is started from the web console: you upload the file there, follow its progress and retrieve the export. It has no public REST endpoint. To automate, the API validates one address per call, and the MCP server checks a list from an AI assistant.
How a job runs
A job runs in five stages. The file is first analysed without consuming anything, then the free checks run on every line. Next come two passes of SMTP verification, the second catching up with servers that deferred. Finally the file is returned, and the credits of unknown addresses are given back to you.
| Stage | What happens |
|---|---|
| Upload and preview | The file is analysed before processing: columns detected, duplicates, unreadable lines. Nothing is consumed yet. |
| Checks with no credit | The nineteen free checks run on every line: syntax, DNS, disposable domains, typosquatting, role accounts, no-reply addresses, domain health. |
| First SMTP pass | Eligible addresses are verified with their mail server, at a pace suited to each receiving server. |
| Second SMTP pass | Addresses still unknown after the first pass are probed again later, which catches up with temporary deferrals. |
| Delivery | The file is returned line by line, and addresses still unknown are credited back automatically when the job closes. |
- Upload and preview done
- Checks with no credit done
- First SMTP pass in progress
- Second SMTP pass waiting
- Delivery waiting
Verdicts returned, line by line
- valid
- invalid
- risky
- unknown
The pace of verification adapts to each receiving server, for smooth processing from start to finish, with nothing for you to configure.
Measure a list before processing it
Audit mode answers a precise question: what is this file worth, and what would full processing cost? It measures exactly what can be measured without a probe, estimates deliverability on a sample probed free of charge, and charges no credit. It is the mode that lets you decide before you spend.
What the audit gives you
Audit mode produces a quality report on a whole file without charging a single credit. It measures exactly what can be measured without a probe, estimates deliverability from a sample probed free of charge, and works out what full processing would cost before it is launched.
And then
The line by line detail is delivered by full processing, which the audit lets you launch with full knowledge of the facts.
The audit checks a sample of your file over SMTP, and these checks are on us. The sample is drawn by provider, in proportion to the real weight of each one in the file, for an estimate that faithfully reflects the make up of your list.
Audit a file without spending a credit
What is billed, and what is not
The rule for batch processing is the real-time rule, applied line by line. One credit is charged for each address whose SMTP verification reached a verdict. Credits are reserved at launch, and those of addresses left unknown are returned to you automatically when the job closes.
A credit is charged if and only if SMTP verification was requested and the final status is not "unknown".
| Case | What the engine does |
|---|---|
| SMTP verification was not requested | The call carries "smtp: false". The other nineteen checks run with no quota. |
| The address is on the organisation's allow list | SMTP is skipped, the list decides. |
| The address is on the organisation's block list | SMTP is skipped, the list decides. |
| The final status is "unknown" | In real time, nothing is charged. In batch processing, these addresses are credited back automatically when the file is closed. |
| The file is processed in audit mode | Audit mode charges no credit, including for the sample it checks over SMTP. |
The 19 free checks apply to every line of the file, with no quota. A disposable domain is verified like any other, and counts one credit when the final status reaches a verdict.
Frequently asked questions
- How much does processing a file cost?
- One credit per address for which SMTP verification reached a verdict. Addresses left unknown are not billed: their credits are returned automatically when the job closes. The nineteen free checks apply to every line, with no quota.
- Can I know the quality of a list before paying?
- Yes, that is the role of audit mode. It counts exactly what can be measured without a probe across the whole list, estimates deliverability from a sample probed free of charge, and charges no credit. It also tells you how many SMTP checks full processing would actually require.
- Why two SMTP passes instead of one?
- To obtain a firm answer where a server first asked to come back later, as greylisting does. The second pass returns later to the addresses left unknown, and most often obtains a definitive verdict.
- Which file formats are accepted?
- For import, CSV and TXT, which every tool can produce. For export, the result is available as CSV, XLSX and PDF.
Going further
The API reference page brings together the parameters, the response codes and the detail of the checks applied to each line. To validate an address at the moment it is entered rather than in bulk, real-time validation uses the same engine and the same billing rules.