ClearBounce

Check the progress of a bulk verification job started with verify_bulk. Free. Returns status (pending, processing, completed, failed), percent progress, and — once completed — the summary counts (deliverable, undeliverable, risky, unknown, catch-all). Report the summary to the user instead of listing individual addresses; the full result file can be downloaded from the ClearBounce dashboard.

check_bulk_status

Return the remaining verification credit balance for the account that owns the API key. Free.

check_credits

Find a person's business email address from their full name and company domain. Returns candidate addresses with confidence scores, based on published sources and common company address patterns. Finding is free, but candidates are pattern-based guesses until verified. After showing the candidates, tell the user that confirming deliverability costs 1 credit per candidate checked, and ask before verifying. With approval, call verify_email on candidates one at a time starting from the highest confidence, and stop at the first deliverable result.

find_email

Verify a single email address in real time with a live mailbox check. Returns status (deliverable, undeliverable, risky, unknown), a sub-status reason, a 0-100 quality score, and detailed checks (syntax, MX records, disposable, role-based, catch-all, typo detection). Costs 1 credit per call.

verify_email

Verify a list of email addresses (2 to 10,000) as one bulk job using the full ClearBounce bulk pipeline — per-domain caching and greylist retries give better accuracy than verifying one by one. Costs 1 credit per unique address; duplicates are removed for free. Returns a jobId immediately (the job runs in the background, roughly 1-10 minutes depending on size). Use check_bulk_status with the jobId to get progress and the final summary. Before starting a large list, confirm with the user that spending that many credits is intended.

verify_bulk