Official Python SDK for the VerifyForge Email Validation API.
- 🔍 Hybrid Validation - Syntax, MX records, SMTP verification, and disposable detection
- ⚡ Fast & Reliable - Optimized for speed with smart caching
- 🚀 Bulk Processing - Validate up to 100 emails in a single request
- 💯 Type Safe - Full type hints for better IDE support
- 🛡️ Error Handling - Comprehensive error handling with custom exceptions
- 🔐 Secure - API key authentication
pip install verifyforgefrom verifyforge import VerifyForge
# Initialize the client
client = VerifyForge(api_key="your_api_key_here")
# Validate a single email
result = client.validate("user@example.com")
if result.data.is_valid:
print(f"✓ Email is valid!")
print(f"Reachability: {result.data.reachability}")
else:
print(f"✗ Email is invalid")
print(f"Credits remaining: {result.remaining_credits}")from verifyforge import VerifyForge
client = VerifyForge(api_key="your_api_key")
# Validate an email
result = client.validate("test@example.com")
# Access validation details
print(f"Email: {result.data.email}")
print(f"Valid: {result.data.is_valid}")
print(f"Disposable: {result.data.disposable}")
print(f"Role Account: {result.data.role_account}")
print(f"Free Provider: {result.data.free_provider}")
print(f"Reachability: {result.data.reachability}")
# Check MX records
for mx in result.data.mx_records_list:
print(f"MX: {mx.exchange} (priority: {mx.priority})")
# SMTP analysis
smtp = result.data.smtp
if smtp.connection_successful:
print(f"SMTP accepts mail: {smtp.accepts_mail}")from verifyforge import VerifyForge
client = VerifyForge(api_key="your_api_key")
# Validate multiple emails
emails = [
"user1@example.com",
"user2@example.com",
"user3@example.com",
]
result = client.validate_bulk(emails)
# Summary statistics
print(f"Total validated: {result.summary.total}")
print(f"Duplicates removed: {result.summary.duplicates_removed}")
print(f"Credits used: {result.credits_used}")
# Individual results
for item in result.results:
status = "✓" if item.is_valid else "✗"
print(f"{status} {item.email} - {item.reachable}")from verifyforge import (
VerifyForge,
VerifyForgeError,
AuthenticationError,
InsufficientCreditsError,
ValidationError,
)
client = VerifyForge(api_key="your_api_key")
try:
result = client.validate("test@example.com")
except AuthenticationError:
print("Invalid API key")
except InsufficientCreditsError:
print("Not enough credits")
except ValidationError as e:
print(f"Validation error: {e.message}")
print(f"Details: {e.details}")
except VerifyForgeError as e:
print(f"API error: {e}")from verifyforge import VerifyForge
# Automatically closes the session when done
with VerifyForge(api_key="your_api_key") as client:
result = client.validate("test@example.com")
print(f"Valid: {result.data.is_valid}")from verifyforge import VerifyForge
# Custom base URL and timeout
client = VerifyForge(
api_key="your_api_key",
base_url="https://custom-domain.com", # Optional
timeout=60, # Request timeout in seconds
)Main client class for interacting with the VerifyForge API.
VerifyForge(api_key: str, base_url: str = "https://verifyforge.com", timeout: int = 30)Parameters:
api_key(str): Your VerifyForge API keybase_url(str, optional): Base URL for the API. Defaults to "https://verifyforge.com"timeout(int, optional): Request timeout in seconds. Defaults to 30
Validate a single email address.
Parameters:
email(str): Email address to validate
Returns:
ValidationResponse: Complete validation results
Raises:
ValidationError: If email format is invalidInsufficientCreditsError: If account has insufficient creditsAPIError: If validation fails
Validate multiple email addresses (up to 100).
Parameters:
emails(List[str]): List of email addresses to validate
Returns:
BulkValidationResponse: Results for all emails with summary
Raises:
ValidationError: If email list is invalid or exceeds 100 emailsInsufficientCreditsError: If account has insufficient creditsAPIError: If validation fails
@dataclass
class ValidationResponse:
success: bool
data: ValidationResult
credits_used: int
remaining_credits: int
validation_duration: Optional[int]
api_version: Optional[str]@dataclass
class ValidationResult:
email: str
is_valid: bool
syntax: SyntaxValidation
mx_records_list: List[MXRecord]
smtp: SMTPAnalysis
disposable: bool
role_account: bool
free_provider: bool
reachability: str # "safe", "risky", "invalid", "unknown"
suggestion: Optional[str]
gravatar: Optional[Gravatar]@dataclass
class BulkValidationResponse:
success: bool
results: List[BulkValidationResult]
summary: BulkValidationSummary
credits_used: int
remaining_credits: int
duration: Optional[int]
api_version: Optional[str]All exceptions inherit from VerifyForgeError:
AuthenticationError: Invalid API key (401)InsufficientCreditsError: Insufficient credits (402)ValidationError: Request validation failed (400)RateLimitError: Rate limit exceeded (429)APIError: General API error (5xx)
- Python 3.8+
- requests >= 2.31.0
# Clone the repository
git clone https://github.com/VerifyForge/python-sdk.git
cd python-sdk
# Install development dependencies
pip install -e ".[dev]"
# Run tests
pytest
# Run type checking
mypy verifyforge
# Format code
black verifyforge
# Lint code
ruff check verifyforge- 📧 Email: contact@verifyforge.com
- 📚 Documentation: https://verifyforge.com/api-docs
- 🐛 Bug Reports: https://github.com/VerifyForge/python-sdk/issues
This project is licensed under the MIT License - see the LICENSE file for details.