Batch Validation: Checking a Whole File of Addresses

When you have tens of thousands of addresses rather than ten, sending them through the API one by one gets tedious. That is what the Batch section of your account is for. You upload a list, the service works through it on its own and collects the results in a table you can download later.

What file works

CSV and TXT files up to 50 MB are accepted, one at a time. The service reads the file line by line and takes the first value containing an @ sign. Values can be separated by commas, semicolons or tabs, so a regular export from a CRM or Excel usually works as is.

• Lines without an address are skipped, so a header row will not get in the way.
• Quotes around a value and spaces inside an address are removed, and the address is lowercased.
• If a line has several addresses, only the first one is taken.
• Duplicates are not removed. Every line is checked and billed separately, so it is worth cleaning up repeats beforehand.

Name,City,Address
John Smith,London,john.smith@gmail.com
"Anna Brown","Leeds","Anna.Brown@Outlook.com"
sales@example.com

This file gives three addresses. The first line is skipped, and Anna.Brown@Outlook.com becomes anna.brown@outlook.com.

Uploading and starting

Validation happens in two steps. First the file is uploaded and parsed, and the check itself starts only after you confirm it. That way you do not spend your balance if you picked the wrong file.

• Open the Batch section and click Upload. Drag the file into the window or pick it from disk.
• While the file is being read, its status is Loading. A large file may take a little while, and you can close the page in the meantime.
• Once the status changes to Uploaded, look at how many addresses the service found. If the number is way off, the file is most likely in a different format.
• If everything looks right, click Start validation.

If the file has no addresses at all, the upload gets the Error status with an explanation. Fix the file and upload it again.

While it runs

During validation the status is Processing. The upload page shows how many addresses have been checked, how many of them are Good, Bad and Unknown, and roughly how much time is left. Results show up in the table right away, you do not have to wait until the end.

You can pause the check with the Pause button and continue later from the same spot. Addresses that were already being checked at that moment will still finish.

If an address could not be checked because of a technical failure, the service tries once more. After the second failure the line is marked as an error and counted separately.

What it costs

Billing works the same as with API requests. You pay only for a definite Good or Bad answer. Unknown and error lines are free. With a subscription, the daily allowance is used first and anything above it is taken from your balance.

To start validation your balance has to be above zero. If it runs out halfway, the check pauses on its own with the Paused status. Top up and click Resume, and the service picks up where it stopped. Addresses that were already checked are not charged again.

Results

When every line has been processed, the status changes to Finished. You can browse the table with filters right in your account or download it as CSV. Downloading also works for a paused check, in which case the file contains whatever was checked so far.

email;status;detail;humaneness;suspicious;gmailDotTrick;aliasEmail;createdAt
john.smith@gmail.com;Good;Mailbox accepts mail;0.9734;false;false;;2026-10-20T09:15:02.118Z

The file is named after the original with a -result suffix. Columns are separated by semicolons and the file starts with a byte order mark, so Excel opens it correctly, non-Latin text included. The first column is the address itself, then:

• status and detail are the verdict and its explanation, the same as in the API response.
• humaneness is a score from 0 to 1 showing how much the address looks like one a person chose. See Humaneness.
• suspicious means the address does not look like something a person would type. See Suspicious addresses.
• gmailDotTrick means the address is a variant of one already seen. See Gmail dot trick.
• aliasEmail is the normalized form of the address when it differs from the original. See Email normalization.
• createdAt is when the line was added to the upload.

Deleting an upload

You can delete an upload along with the original file and its results as long as it is not being validated. If a check is running, pause it first.

Users with view-only access can browse and download results but cannot upload files.