A high-performance, cost-effective email validation service designed for indie hackers and small startups. The service validates email addresses in real-time, checking syntax, domain existence, MX records, and detecting disposable email providers. The main focus is on precision instead of recall, meaning instead of edge cases the focus is on having the biggest coverage.
🌐 Website: https://rapid-email-verifier.fly.dev/
🚀 API https://rapid-email-verifier.fly.dev/api/validate
This is a completely free and open source email validation API that never stores your data. Built to support solopreneurs and the developer community. Features include:
- Zero data storage - your emails are never saved!
- GDPR, CCPA, and PIPEDA compliant
- No authentication required
- No usage limits
- Quick response times
- Batch validation up to 100 emails
- ✅ Syntax validation
- 🌐 Domain existence check
- 📨 MX record validation
- 🚫 Disposable email detection
- 👥 Role-based email detection
- 🔍 Email alias detection for major providers (Gmail, Yahoo, Outlook/Hotmail)
- ✍️ Typo suggestions
- 📊 Real-time monitoring
- 🔄 Batch processing support with domain-level optimizations
Note on Validation Approach: While email RFCs (5321, 5322) define extensive rules for valid email formats, many of these rules are not practically enforced by modern email servers. Our validation takes a practical approach, focusing on rules that are actually enforced by major email providers. For example, we don't support quoted strings in local parts (
"john doe"@example.com) even though they're technically valid according to RFC, as they're rarely supported in practice and often cause issues.
// Standard email
{
"email": "user@example.com",
"validations": {
"syntax": true,
"domain_exists": true,
"mx_records": true
},
"status": "VALID"
}
// Email with plus addressing
{
"email": "user+tag@example.com",
"validations": {
"syntax": true,
"domain_exists": true,
"mx_records": true
},
"status": "VALID"
}
// International email (Unicode)
{
"email": "用户@例子.广告",
"validations": {
"syntax": true,
"domain_exists": true,
"mx_records": true
},
"status": "VALID"
}
// Hindi characters
{
"email": "अजय@डाटा.भारत",
"validations": {
"syntax": true,
"domain_exists": true,
"mx_records": true
},
"status": "VALID"
}// Missing @ symbol
{
"email": "invalid-email",
"validations": {
"syntax": false
},
"status": "INVALID_FORMAT"
}
// Double dots in local part
{
"email": "john..doe@example.com",
"validations": {
"syntax": false
},
"status": "INVALID_FORMAT"
}
// Spaces in quotes (not supported)
{
"email": "\"john doe\"@example.com",
"validations": {
"syntax": false
},
"status": "INVALID_FORMAT"
}
// Multiple @ symbols
{
"email": "user@domain@example.com",
"validations": {
"syntax": false
},
"status": "INVALID_FORMAT"
}// Disposable email detection
{
"email": "user@tempmail.com",
"validations": {
"syntax": true,
"domain_exists": true,
"mx_records": true,
"is_disposable": true
},
"status": "DISPOSABLE"
}
// Role-based email detection
{
"email": "admin@company.com",
"validations": {
"syntax": true,
"domain_exists": true,
"mx_records": true,
"is_role_based": true
},
"status": "PROBABLY_VALID"
}
// Email alias detection
{
"email": "user.name+test@gmail.com",
"validations": {
"syntax": true,
"domain_exists": true,
"mx_records": true
},
"status": "VALID",
"aliasOf": "username@gmail.com"
}// Request
POST /api/validate/batch
{
"emails": [
"user@example.com",
"invalid-email",
"user@nonexistent.com",
"admin@company.com"
]
}
// Response
{
"results": [
{
"email": "user@example.com",
"validations": {
"syntax": true,
"domain_exists": true,
"mx_records": true
},
"status": "VALID"
},
{
"email": "invalid-email",
"validations": {
"syntax": false
},
"status": "INVALID_FORMAT"
},
{
"email": "user@nonexistent.com",
"validations": {
"syntax": true,
"domain_exists": false
},
"status": "INVALID_DOMAIN"
},
{
"email": "admin@company.com",
"validations": {
"syntax": true,
"domain_exists": true,
"mx_records": true,
"is_role_based": true
},
"status": "PROBABLY_VALID"
}
]
}The service can detect email aliases for major email providers and identify the canonical form of the email address.
| Provider | Alias Format | Example | Canonical Form |
|---|---|---|---|
| Gmail | Dots in local part | user.name@gmail.com |
username@gmail.com |
| Gmail | Plus addressing | username+test@gmail.com |
username@gmail.com |
| Yahoo | Hyphen addressing | username-test@yahoo.com |
username@yahoo.com |
| Outlook/Hotmail | Plus addressing | username+test@outlook.com |
username@outlook.com |
When an email is validated, the service checks if it's an alias for a supported provider. If it is, the aliasOf field in the response will contain the canonical form of the email address.
{
"email": "user.name+test@gmail.com",
"validations": {
"syntax": true,
"domain_exists": true,
"mx_records": true
},
"status": "VALID",
"aliasOf": "username@gmail.com"
}The service optimizes batch email validation by grouping emails by domain to avoid redundant domain checks. This significantly reduces network calls and resource usage:
- Emails are grouped by domain before validation
- Domain validations (existence, MX, disposable) are performed once per unique domain
- The cached domain results are applied to all emails with the same domain
- Original order and response accuracy are preserved
This optimization is particularly effective for large batches with common domains, reducing domain checks from O(n) to O(unique domains).
- Go 1.21+
- Redis (caching, only for domains, not email addresses)
- Prometheus (metrics)
- Grafana (monitoring)
- Docker & Docker Compose
- Go 1.21 or higher
- Docker and Docker Compose
- Git
- VSCode (recommended)
# Using Homebrew
brew install go
# Verify installation
go version # Should show go version 1.21 or higher# Add Go repository
sudo add-apt-repository ppa:longsleep/golang-backports
sudo apt update
# Install Go
sudo apt install golang-go
# Verify installation
go version- Download the installer from Go Downloads
- Run the installer
- Open Command Prompt and verify:
go versionAdd these to your shell profile (~/.bashrc, ~/.zshrc, etc.):
# Go environment variables
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/binReload your shell or run:
source ~/.bashrc # or ~/.zshrc- Download Docker Desktop for Mac
- Install and start Docker Desktop
- Verify installation:
docker --version
docker-compose --version# Install Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
# Install Docker Compose
sudo apt install docker-compose
# Start Docker
sudo systemctl start docker
# Add your user to docker group (optional)
sudo usermod -aG docker $USER
# Verify installation
docker --version
docker-compose --version- Download and install Docker Desktop for Windows
- Enable WSL 2 if prompted
- Start Docker Desktop
- Verify in Command Prompt:
docker --version
docker-compose --version-
Install VSCode
- Download from Visual Studio Code
- Install for your platform
-
Install Required Extensions
# Essential Extensions - Go (by Go Team at Google) - Docker (by Microsoft) - GitLens (by GitKraken) - Remote Development (by Microsoft) # Recommended Extensions - Error Lens - Go Test Explorer - YAML - Markdown All in One -
Configure Go Extension After installing the Go extension:
- Open Command Palette (Cmd/Ctrl + Shift + P)
- Type "Go: Install/Update Tools"
- Select all tools and click OK
This will install:
- gopls (Go language server)
- dlv (debugger)
- golangci-lint (linter)
- goimports (code formatter)
- and other essential Go tools
-
VSCode Settings Create or update
.vscode/settings.json:{ "go.useLanguageServer": true, "go.lintTool": "golangci-lint", "go.lintFlags": ["--fast"], "editor.formatOnSave": true, "[go]": { "editor.defaultFormatter": "golang.go", "editor.codeActionsOnSave": { "source.organizeImports": true } } } -
Debugging Setup Create
.vscode/launch.json:{ "version": "0.2.0", "configurations": [ { "name": "Launch Email Validator", "type": "go", "request": "launch", "mode": "auto", "program": "${workspaceFolder}", "env": {}, "args": [] } ] }
# Install golangci-lint
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
# Install air for hot reload (optional)
go install github.com/cosmtrek/air@latest
# Install mockgen for testing
go install github.com/golang/mock/mockgen@latest- Clone the Repository
git clone https://github.com/umuterturk/email-verifier.git
cd email-verifier- Install Dependencies
go mod tidy- Start Monitoring Stack
docker-compose up -d- Build and Run the Service
go build
./emailvalidatorThe service will be available at:
- API: http://localhost:8080
- Metrics: http://localhost:8080/metrics
- Grafana: http://localhost:3000 (admin/admin)
- Prometheus: http://localhost:9090
.
├── cmd/ # Command line tools
├── internal/
│ ├── api/ # HTTP handlers
│ ├── middleware/ # HTTP middleware components
│ ├── model/ # Data models
│ ├── repository/ # Data access layer
│ └── service/ # Business logic
│ ├── email_service.go # Core email validation service
│ ├── batch_validation_service.go # Batch processing with domain optimizations
│ ├── domain_validation_service.go # Domain validation with concurrency
│ └── interfaces.go # Service interfaces for DI
├── pkg/
│ ├── validator/ # Email validation logic
│ │ ├── email.go # Email syntax and validation
│ │ ├── domain.go # Domain validation
│ │ ├── role.go # Role-based email detection
│ │ ├── disposable.go # Disposable email detection
│ │ └── alias_detector.go # Email alias detection
│ ├── monitoring/ # Metrics and monitoring
│ └── cache/ # Caching implementation
├── test/ # Unit, integration and acceptance tests
└── config/ # Configuration files
The service follows a layered architecture with dependency injection for testability:
-
API Layer: HTTP handlers for REST endpoints
- Validates request data
- Translates to/from service layer models
- Implements rate limiting and authentication
-
Service Layer: Core business logic
EmailService: Main validation serviceBatchValidationService: Optimized batch processing with domain groupingDomainValidationService: Concurrent domain validation- Uses interfaces for dependency injection
-
Validation Layer: Email validation logic
- Syntax validation
- Domain validation
- Role-based detection
- Disposable email detection
- Email alias detection
-
Repository Layer: Data access
- Cache implementation
- External API clients
- Run All Tests (excluding load tests)
go test ./... -v -skip "Load"- Run Tests with Race Detection
go test -race ./... -skip "Load"Race detection is crucial for identifying potential data races in concurrent code. It's automatically run in CI/CD pipelines and should be run locally before submitting changes.
Common race conditions to watch for:
- Concurrent map access
- Shared variable access without proper synchronization
- Channel operations
- Goroutine lifecycle management
- Run Load Tests
go test ./test/load_test.go -v- Run Linter
golangci-lint run- Format Code
go fmt ./...- Check for Common Mistakes
go vet ./...The project uses GitHub Actions for CI/CD with the following checks:
- Unit tests with race detection
- Integration tests
- Acceptance tests
- Code linting
- Code formatting
- Security scanning
- Dependency updates
All these checks must pass before code can be merged into the main branch.
The project includes several types of tests:
# Run the comprehensive API test suite
./test_api.shThe results provided by this service are based on best-effort validation and should be treated as recommendations rather than absolute truth. Several factors can affect the accuracy of results:
- Domain DNS records may change
- Temporary DNS resolution issues
- Network connectivity problems
- Email server configuration changes
- Rate limiting by email servers
- Syntax validation differences between email providers
This service is provided "as is" without any warranties or guarantees of any kind, either express or implied. The validation results are for informational purposes only and should not be considered legally binding or definitive. We expressly disclaim any liability for damages of any kind arising from the use of this service or its results. Users are solely responsible for verifying the accuracy of email addresses through additional means before using them for any purpose.