BillionVerify LogoBillionVerify

CLI Tools

Email checker for CLI tools. Claude Code, Codex, Gemini CLI integration guides.

AI-powered CLI tools can directly call BillionVerify to verify emails during development, debugging, and automation workflows.

Supported CLI Tools

BillionVerify CLI

In addition to AI-powered tools, BillionVerify provides its own CLI for direct verification:

Installation

npm install -g billionverify

Configuration

bv config set api-key YOUR_API_KEY

Or use environment variable:

export BV_API_KEY=your-api-key

Basic Commands

# Verify single email bv verify user@example.com  # JSON output bv verify user@example.com --json  # Verify multiple emails bv verify user1@example.com user2@test.com  # Verify from file bv verify --file emails.txt  # Check credits bv credits

Output Formats

Human-readable (default):

Email: user@example.com Status: valid Score: 0.95 Deliverable: yes Disposable: no Role: no

JSON output:

bv verify user@example.com --json
{  "email": "user@example.com",  "status": "valid",  "result": {  "deliverable": true,  "disposable": false,  "role": false  },  "score": 0.95 }

Exit Codes

CodeMeaning
0Success, email is valid
1Email is invalid
2Email status unknown
3API error
4Configuration error

Use in scripts:

if bv verify --quiet user@example.com; then  echo "Email is valid" else  echo "Email is invalid or verification failed" fi

Shell Integration

Add these functions to your .bashrc or .zshrc:

# Quick email verification vmail() {  bv verify "$1" --color }  # Verify and copy result vmail-copy() {  bv verify "$1" --json | pbcopy  echo "Result copied to clipboard" }  # Check if email is valid (returns 0 or 1) is-valid-email() {  bv verify "$1" --quiet &>/dev/null }

Piping and Automation

# Pipe from stdin echo "test@example.com" | bv verify --stdin  # Pipe to other commands bv verify test@example.com --json | jq '.score'  # Extract and verify emails from a file grep -oE '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}' document.txt | \  xargs -I {} bv verify {} --quiet

Next Steps

On this page