Documentation

async function validateSignup(email) {
  const result = await fetch('https://api.verifykit.io/v1/verify', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer vk_live_...',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ email })  // Full SMTP verification by default
  }).then(r => r.json());

  // Block disposable emails
  if (result.disposable) {
    throw new Error('Please use a permanent email address');
  }

  // Block low-quality emails
  if (result.score < 0.7) {
    throw new Error('Email appears invalid');
  }

  return result.valid;
}

import requests

def clean_email_list(email_list):
    response = requests.post(
        'https://api.verifykit.io/v1/verify/bulk',
        headers={'Authorization': 'Bearer vk_live_...'},
        json={'emails': email_list}  # Full SMTP verification included
    )

    results = response.json()

    # Filter valid, deliverable emails
    clean_list = [
        r['email'] for r in results['results']
        if r['valid'] and r['reachable'] == 'safe' and r['score'] > 0.7
    ]

    print(f"Original: {len(email_list)} emails")
    print(f"Clean: {len(clean_list)} emails")
    print(f"Removed: {len(email_list) - len(clean_list)} invalid")

    return clean_list

function EmailInput() {
  const [email, setEmail] = useState('');
  const [status, setStatus] = useState('idle');
  const [error, setError] = useState('');

  const validateEmail = useDebouncedCallback(async (value) => {
    if (!value) return;

    setStatus('validating');

    try {
      const result = await fetch('https://api.verifykit.io/v1/verify', {
        method: 'POST',
        headers: {
          'Authorization': 'Bearer vk_live_...',
          'Content-Type': 'application/json'
        },
        body: JSON.stringify({
          email: value,
          skip_smtp: true  // Fast validation for real-time feedback
        })
      }).then(r => r.json());

      if (!result.valid) {
        setError('Email address appears invalid');
        setStatus('error');
      } else if (result.disposable) {
        setError('Please use a permanent email address');
        setStatus('error');
      } else {
        setError('');
        setStatus('valid');
      }
    } catch (err) {
      setStatus('idle');
    }
  }, 500);

  return (
    <input
      type="email"
      value={email}
      onChange={(e) => {
        setEmail(e.target.value);
        validateEmail(e.target.value);
      }}
      className={status === 'error' ? 'border-red-500' : ''}
    />
  );
}

async function validateWithTypoCheck(email) {
  const result = await fetch('https://api.verifykit.io/v1/verify', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer vk_live_...',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ email, skip_smtp: true })
  }).then(r => r.json());

  // Check for typo suggestion
  if (result.did_you_mean) {
    // Show suggestion to user
    const useCorrection = confirm(
      `Did you mean: ${result.did_you_mean}?`
    );

    if (useCorrection) {
      // Validate the corrected email
      return validateWithTypoCheck(result.did_you_mean);
    }
  }

  return result;
}

// Example results:
// [email protected] → Suggests: [email protected]
// [email protected] → Suggests: [email protected]
// [email protected] → Suggests: [email protected]

async function segmentUser(email) {
  const result = await verifyEmail(email);

  // Use quality_grade for cleaner logic
  switch (result.quality_grade) {
    case 'excellent':
      // High quality - auto-approve, skip extra verification
      return {
        segment: 'premium',
        actions: ['enable_full_access', 'skip_email_verification'],
        onboarding: 'fast_track'
      };

    case 'good':
      // Good quality - standard flow
      return {
        segment: 'standard',
        actions: ['send_verification_email'],
        onboarding: 'normal'
      };

    case 'fair':
      // Risky - require extra verification
      return {
        segment: 'risky',
        actions: ['require_phone_verification', 'limit_initial_access'],
        onboarding: 'cautious'
      };

    case 'poor':
    default:
      // Low quality or no grade - reject
      return {
        segment: 'reject',
        actions: ['block_signup'],
        message: 'Please use a valid email address'
      };
  }
}

// Or use numeric scores for more granular control
if (result.score >= 0.9) { /* ... */ }
else if (result.score >= 0.7) { /* ... */ }