Easy Email Verification

Permanently delete a bulk job and its results (they are also deleted automatically 30 days after upload). Cannot be undone; confirm with the user first. Credits are not refunded.

delete_bulk_job

Status (queued, processing, completed, failed, not_enough_credits), progress in percent and counters of a bulk job. Free. Waits up to wait_seconds (default and maximum 30) and answers as soon as the job ends. After each answer, show the status and progress to the user and call it again, until completed, failed or not_enough_credits. After 10 minutes, stop, give the user the dashboard link and tell them to ask for the job status later.

get_bulk_status

Remaining Easy Email Verification credits of the account that owns the API key. Free: does not consume credits. Use it before large verifications to check the balance.

get_credits

The complete results file (CSV) of a completed bulk job, for jobs of up to 2000 addresses: hand it to the user as a .csv file. Larger jobs only get download_url. Free.

get_bulk_csv

Bulk jobs of this account with their status (results are kept for 30 days). Use it when the user asks about a job without giving its id. Free.

list_bulk_jobs

Send the next part (up to 5000 addresses) of a list started with create_bulk_job and parts_total. After the last part the whole list is deduplicated and uploaded (one job per 100000 addresses), and the answer is the same as create_bulk_job's. Consumes credits only when the last part starts the job(s).

append_bulk_emails

Start an asynchronous verification job. Use it for 21 or more addresses, or for ANY file the user attaches (read the addresses from the file). Up to 100000 addresses per call. Consumes one credit per unique address and the account needs enough credits for all of them (check with get_credits and tell the user the number before starting). Duplicates and lines that are not addresses are removed first. Lists larger than 10,000: suggest uploading the file on the dashboard (https://dashboard.easyemailverification.com/bulk-email-verification). If the user prefers the chat, send the list in parts of up to 5000: call this tool with parts_total and the first part, then append_bulk_emails with each other part; lists over 100000 become several jobs. Returns list_id (or jobs) and message_for_user: tell the user the job id, that you will report the status every 30 seconds, and the dashboard link. Then call get_bulk_status.

create_bulk_job

Totals of a completed bulk job by result and reason, risk flags, at most 50 example rows (invalid and risky addresses first) and download_url, a link to download the CSV with all results. Never returns the whole list. ALWAYS give the user the download_url link. Free.

get_bulk_summary

Verify 1 to 20 email addresses in one call with Easy Email Verification. Consumes one credit per address. Returns one result per address, with the same fields as verify_email (treat "unknown" as neither valid nor invalid). For 21 or more addresses, or any file the user attaches, use create_bulk_job instead; never split a larger list into several verify_emails calls.

verify_emails

Verify one email address with Easy Email Verification (syntax, domain, MX, mailbox, disposable, role and catch-all checks). Consumes one credit. Read "result": valid, invalid or unknown. "unknown" means no reliable conclusion: treat it as neither valid nor invalid. "safe_to_send" is the overall recommendation; "disposable", "role", "free" and "accept_all" are signals for the user's own policy; "did_you_mean" suggests a typo fix. "success": true only means the request was processed.

verify_email