tomba-verify

Check whether an email address is deliverable from your terminal — powered by the Tomba Email Verifier API.

A single-binary Go CLI that takes one or more email addresses and tells you whether each is deliverable — with status, result, confidence score, SMTP provider, and the MX / SMTP / disposable / webmail / accept-all / gibberish checks — as a table, JSON, or CSV.

Zero SDK dependency. This tool calls the Tomba REST API directly with net/http — the main.go is a complete, working reference for how to integrate Tomba into your own Go code.

Features

• One-shot: tomba-verify b.mohamed@tomba.io
• Batch via args or stdin — clean an entire list in one pipe
• Three output modes: table (default), --json, --csv
• Surfaces score, SMTP provider, and the full check breakdown
• One non-stdlib dep (olekukonko/tablewriter) — calls the API with plain net/http
• Single static binary — drop it in $PATH and go

The curl equivalent

This CLI is just a friendly wrapper around one HTTP call:

curl 'https://api.tomba.io/v1/email-verifier/b.mohamed@tomba.io' \
     -H "X-Tomba-Key: $TOMBA_KEY" \
     -H "X-Tomba-Secret: $TOMBA_SECRET"

Pipe through jq for fields:

curl -s 'https://api.tomba.io/v1/email-verifier/b.mohamed@tomba.io' \
     -H "X-Tomba-Key: $TOMBA_KEY" \
     -H "X-Tomba-Secret: $TOMBA_SECRET" \
  | jq '.data.email | {email, status, result, score}'

Install

Homebrew (macOS / Linux)

brew install tomba-io/tap/tomba-verify

Go install

go install github.com/tomba-io/verify-cli@latest

Pre-built binaries

Grab the latest release from the Releases page.

Setup

You need a free Tomba account — sign up at tomba.io (50 finds + 50 verifications/month, no credit card).

export TOMBA_KEY=ta_xxxxxxxxxxxxxxxxxx
export TOMBA_SECRET=ts_xxxxxxxxxxxxxxxxxx

Usage

# One email → table
tomba-verify b.mohamed@tomba.io

# Several at once
tomba-verify a@stripe.com b@github.com c@vercel.com

# JSON for piping into jq
tomba-verify --json b.mohamed@tomba.io | jq 'select(.[].status == "valid")'

# Clean a whole list into a CSV
cat emails.txt | tomba-verify --csv > verified.csv

Example output

  EMAIL              | STATUS | RESULT      | SCORE | PROVIDER
---------------------+--------+-------------+-------+------------------
  b.mohamed@tomba.io | valid  | deliverable |    99 | Google Workspace

What is this useful for?

• List hygiene — drop invalid and risky addresses before a send to protect deliverability
• Signup gating — reject disposable / gibberish addresses at the boundary
• Lead scoring — keep only high-confidence, deliverable contacts
• Bounce prevention — re-verify a list right before a campaign
• Tomba pipeline — feed it the output of domain-search to re-check found emails

Development

go build -o tomba-verify
./tomba-verify --version

Regenerate the demo GIF

The demo at the top is generated by VHS from .vhs/demo.tape:

vhs .vhs/demo.tape
# outputs docs/demo.gif

License

MIT — see LICENSE.

Related

• Tomba Go SDK
• Tomba API docs
• domain-search-cli — find the emails behind a domain
• tech-cli — detect the technology stack of a domain