Skip to content
Docs

How-to

Verify up to 10,000 email addresses at once by pasting them or uploading a CSV or XLSX file, follow progress, review results and export them as XLSX.

Updated Oct 9, 2026

A verification list checks many addresses in one go, for example before you import contacts from another system or send a campaign to an old list. This guide shows how to create a list, follow its progress, read the results and export them.

Before you begin

  • A list can contain up to 10,000 addresses. Split bigger files into several lists.
  • Each unique address costs 5 credits, charged when you create the list. A list of 10,000 addresses needs 50,000 credits.
  • Lists always use full mode, which includes the mailbox check. See Fast and full mode.
  • For the API, use an API key with Full Access.

Create a list

  1. Open Lists. Go to Email VerificationLists and select Verify emails.

  2. Name the list. In Name, enter something you’ll recognize later, such as Newsletter import October.

  3. Add the addresses. Under Input Method, choose one:

    • Enter emails manually: paste addresses into Email Addresses, separated by commas, semicolons or new lines.
    • Upload a file: choose a .csv or .xlsx file smaller than 10 MB. In a CSV, put one address per row or separate them with commas. In Excel, put them in the first column, one per row. The dialog shows how many addresses it found.
  4. Select Create. Emailit charges the credits and starts verifying.

Before charging, Emailit cleans up the input: it lowercases every address, removes duplicates and drops entries without an @. You’re only charged for the unique addresses that remain. If the list can’t be started, the credits are refunded.

Follow progress

The list’s status moves through these stages:

Status Meaning
pending Created, waiting to start.
processing Addresses are being verified.
completed Every address has a final result.
failed The list couldn’t be processed.
canceled Verification was stopped.

In Email VerificationLists, the Statistics column shows, for each list, the Total and Pending addresses and how many finished as Safe (safe and role), Risky (catch_all, unknown and inbox_full) and Invalid (invalid, disabled and disposable). The counts update as addresses finish. The Expiring column shows how many days are left before the list is deleted.

When a mail server defers the check (greylisting) or can’t be reached, Emailit checks that address again after 5 minutes and after another 15, so a list can wait on its last few addresses for up to about 20 minutes. They count as Pending until then.

With the API, call Retrieve a list and read status and stats. stats is updated as each address finishes, and stats.results counts the finished addresses by result. To avoid polling, subscribe a webhook to email_verification_list.updated, which fires when the list completes. Each address also fires email_verification.updated when its final result is ready.

Review the results

Select a list in the dashboard to open it. The page shows:

  • cards with Created, Status, Total Emails, Pending, Verified (addresses with a final result, whatever it is) and Errors (addresses an error stopped Emailit from checking),
  • charts for Verification Status Progress, the results (Results so far while the list is processing, then Verification Results Breakdown) and Risk Levels, counted over the addresses that finished,
  • a table of every address with its status, result, risk and score.

With the API, call List results. Filter by result or status and page through with page and limit (default 50):

Terminal
curl -G https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/results \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "result=invalid" \
  --data-urlencode "limit=100"

Each item has the same fields as a single verification: result, score, risk, every check in checks, the address parts, did_you_mean and mx_records. Verification results explains every value and what to do with it.

Export the results

Once a list is completed, you can download all its results as an Excel file.

Open the list and select Export Results. Emailit downloads an .xlsx file named after the list’s ID.

The file has one row per address with its status, result, score and risk, every individual check (valid syntax, disposable, role account, inbox full, deliverable, disabled, free email, gibberish, catch-all, SMTP connect, MX records), the address parts, domain age, the did_you_mean suggestion and the MX records. Results are color-coded so you can scan them quickly.

Use the results

  1. Remove addresses with the result invalid, disabled or disposable before you import or send.
  2. Review catch_all, unknown, inbox_full and role addresses. Keep them if you have a reason to, but watch their bounces.
  3. Import the safe addresses and the ones you kept into your contacts or audience.

See Recommended actions for each result.

Every result, risk level and check.
Create lists and read results from code.

Was this page helpful?

Thanks for the feedback.

Thanks, we read every message.