Bulk Email Verification API

1. Submit a list for verification

Accepts application/json, application/x-www-form-urlencoded, or multipart/form-data. Emails can be a comma-separated string or a JSON array. Duplicate addresses are detected automatically and excluded from the processed totals.

{
  "key": "YOUR_API_KEY",
  "listName": "October signups",
  "emails": [
    "user1@example.com",
    "user2@example.com"
  ]
}

{
  "message": "Bulk request accepted",
  "bulkId": "0b7f9d47-3f8e-4a41-9be2-6c1e0f2d9a11"
}

2. Check processing status

{
  "message": "Your batch is being processed.",
  "processed": 25000,
  "total": 40000
}

{
  "message": "Your batch has been processed successfully.",
  "processed": 40000,
  "total": 40000
}

Poll every 30–60 seconds. Large lists with slow mail servers can take a while — the batch is complete when processed equals total.

3. Download the results CSV

Returns a CSV file (named like bulk_<bulkId>.csv) with the verdict for every address. If the batch is still running, the endpoint responds with 400 and a message asking you to try again later.

4. Check your credits balance

Each verified address consumes one credit, so check your balance before submitting a large list. This call is free and never consumes a credit.

{
  "balance": 12450
}

Complete example (Python)

import time

import requests

BASE_URL = "https://api.validemail.net"
API_KEY = "YOUR_API_KEY"

emails = ["user1@example.com", "user2@example.com", "user3@example.com"]

# 0. Make sure we have enough credits
balance = requests.get(f"{BASE_URL}/v1/bulk/balance", params={"key": API_KEY}).json()["balance"]
assert balance >= len(emails), f"Not enough credits: {balance} < {len(emails)}"

# 1. Submit the list
submit = requests.post(
    f"{BASE_URL}/v1/bulk",
    json={"key": API_KEY, "listName": "My list", "emails": emails},
)
submit.raise_for_status()
bulk_id = submit.json()["bulkId"]

# 2. Poll until finished
while True:
    status = requests.get(
        f"{BASE_URL}/v1/bulk/status", params={"id": bulk_id, "key": API_KEY}
    ).json()
    print(f"{status['processed']}/{status['total']} processed")
    if status["total"] > 0 and status["processed"] >= status["total"]:
        break
    time.sleep(30)

# 3. Download the CSV
csv_bytes = requests.get(
    f"{BASE_URL}/v1/bulk/downloadcsv", params={"id": bulk_id, "key": API_KEY}
).content

with open(f"bulk_{bulk_id}.csv", "wb") as file:
    file.write(csv_bytes)

print("Results saved.")