Python Integration

Using the requests library.

import requests

def validate_email(email):
    url = "https://api.checkemail.dev/validate"
    headers = {
        "x-api-key": "ce_d_YOUR_API_KEY"
    }
    params = { "email": email }

    response = requests.get(url, headers=headers, params=params)
    
    if response.status_code == 200:
        data = response.json()
        confidence = data.get("confidence", {})
        validations = data.get("validations", {})
        
        # Check for disposable
        if confidence.get("status") == "DISPOSABLE" or validations.get("is_disposable"):
            print("Disposable email detected!")
            return False
        
        # Handle aliases for deduplication
        if confidence.get("alias_status") == "ALIAS_CONFIRMED":
            print(f"Primary email is actually: {confidence.get('canonical_email')}")
            
        return confidence.get("status") == "LIKELY"
    else:
        print(f"Error: {response.status_code}")
        return False

# Usage
is_valid = validate_email("[email protected]")