Email Verification API Integration Guide

POST https://verifyemail.io/api/email?method=verifyemail&email={EMAIL_ADDRESS}

curl -X POST "https://verifyemail.io/api/email?method=verifyemail&email=test@example.com" \
     -H "Authorization: Bearer YOUR_API_KEY"

{
    "EMAIL": "test@example.com",
    "VERDICT": "Valid",
    "SCORE": 95,
    "LOCAL": "test",
    "DOMAIN": "example.com",
    "DOMAIN_VERDICT": "Valid",
    "MX": "mx1.example.com, mx2.example.com",
    "HAS_SUSPECTED_BOUNCES": 0,
    "LOCAL_PART_IS_SUSPECTED_ROLE_ADDRESS": 0,
    "HAS_KNOWN_BOUNCES": 0,
    "DOMAIN_IS_SUSPECTED_DISPOSABLE_ADDRESS": 0
}

import requests

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://verifyemail.io/api/email'

def verify_email(email):
    """Verify a single email address and return the result."""
    response = requests.post(
        BASE_URL,
        params={
            'method': 'verifyemail',
            'email': email
        },
        headers={
            'Authorization': f'Bearer {API_KEY}'
        }
    )

    response.raise_for_status()
    data = response.json()

    return {
        'email': data['EMAIL'],
        'verdict': data['VERDICT'],
        'score': data['SCORE'],
        'is_disposable': data.get('DOMAIN_IS_SUSPECTED_DISPOSABLE_ADDRESS') == 1,
        'is_role_address': data.get('LOCAL_PART_IS_SUSPECTED_ROLE_ADDRESS') == 1,
        'has_bounces': data.get('HAS_KNOWN_BOUNCES') == 1,
        'domain_verdict': data['DOMAIN_VERDICT'],
        'mx': data.get('MX', '')
    }

# Usage
result = verify_email('test@example.com')
print(f"Email: {result['email']}")
print(f"Verdict: {result['verdict']}")
print(f"Score: {result['score']}")

import csv
import time
import requests

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://verifyemail.io/api/email'

def verify_email(email):
    """Verify a single email and return the API response."""
    response = requests.post(
        BASE_URL,
        params={'method': 'verifyemail', 'email': email},
        headers={'Authorization': f'Bearer {API_KEY}'}
    )
    response.raise_for_status()
    return response.json()

def process_csv(input_file, output_file):
    """Read emails from a CSV, verify each, and write results."""
    with open(input_file, 'r') as infile, open(output_file, 'w', newline='') as outfile:
        reader = csv.DictReader(infile)
        fieldnames = [
            'email', 'verdict', 'score', 'domain',
            'domain_verdict', 'mx', 'is_disposable',
            'is_role_address', 'has_known_bounces'
        ]
        writer = csv.DictWriter(outfile, fieldnames=fieldnames)
        writer.writeheader()

        for row in reader:
            email = row.get('email', '').strip()
            if not email:
                continue

            try:
                data = verify_email(email)
                writer.writerow({
                    'email': data['EMAIL'],
                    'verdict': data['VERDICT'],
                    'score': data['SCORE'],
                    'domain': data['DOMAIN'],
                    'domain_verdict': data['DOMAIN_VERDICT'],
                    'mx': data.get('MX', ''),
                    'is_disposable': data.get('DOMAIN_IS_SUSPECTED_DISPOSABLE_ADDRESS', 0),
                    'is_role_address': data.get('LOCAL_PART_IS_SUSPECTED_ROLE_ADDRESS', 0),
                    'has_known_bounces': data.get('HAS_KNOWN_BOUNCES', 0)
                })
                print(f"Verified: {email} -> {data['VERDICT']}")
            except requests.exceptions.RequestException as e:
                print(f"Error verifying {email}: {e}")

            # Respect rate limits
            time.sleep(0.5)

# Usage
process_csv('emails.csv', 'verified_emails.csv')
print('Verification complete. Results saved to verified_emails.csv')

async function verifyEmailSafe(email) {
    const MAX_RETRIES = 3;

    for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
        try {
            const response = await fetch(
                `https://verifyemail.io/api/email?method=verifyemail&email=${encodeURIComponent(email)}`,
                {
                    method: 'POST',
                    headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
                }
            );

            if (response.status === 401) {
                throw new Error('Invalid API key. Check your credentials.');
            }

            if (response.status === 429) {
                throw new Error('Rate limit exceeded. Upgrade your plan.');
            }

            if (!response.ok && response.status >= 500) {
                throw new Error(`Server error: ${response.status}`);
            }

            const data = await response.json();

            // Check for rate limit message in body
            if (data.MONTHLY_REQUEST_MAX_API) {
                console.warn('Monthly limit reached:', data.MONTHLY_REQUEST_MAX_API);
                return { verdict: 'unknown', limitReached: true };
            }

            return { verdict: data.VERDICT, score: data.SCORE, data: data };

        } catch (error) {
            if (attempt === MAX_RETRIES) {
                console.error('All retries exhausted:', error.message);
                // Fail open: allow the email through
                return { verdict: 'unknown', error: error.message };
            }
            // Exponential backoff
            await new Promise(r => setTimeout(r, Math.pow(2, attempt) * 1000));
        }
    }
}