Verify a list

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

curl https://api.emailit.com/v2/email-verification-lists \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Newsletter import October",
    "emails": ["ada@example.com", "grace@example.com", "alan@example.com"]
  }'

{
  "object": "email_verification_list",
  "id": "evl_3Rt8Wq5Lm2Kx",
  "name": "Newsletter import October",
  "status": "processing",
  "stats": {
    "total_emails": 3,
    "processed_emails": 0,
    "successful_verifications": 0,
    "failed_verifications": 0,
    "pending_emails": 3
  },
  "created_at": "2026-10-01T11:02:37Z",
  "updated_at": "2026-10-01T11:02:37Z",
  "valid_emails_count": 3,
  "unique_emails_count": 3,
  "invalid_emails_count": 0,
  "dispatched_jobs": 3
}

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:

In Email Verification›Lists, the Statistics column shows Total, Pending, Successful and Failed counts for each list. The Expiring column shows how many days are left before the list is deleted.

With the API, call Retrieve a list and read status and stats. 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 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, Successful and Failed,
• charts for Verification Status Progress, Verification Results Breakdown and Risk Levels,
• 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):

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 address’s id, email, status, result, score, risk 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.

curl https://api.emailit.com/v2/email-verification-lists/evl_3Rt8Wq5Lm2Kx/export \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -o results.xlsx

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 inbox_full, role and unknown addresses. Keep them if you have a reason to, but watch their bounces.
3. Import the rest into your contacts or audience.

See Recommended actions for each result.

Related