How reacherhq/check-if-email-exists works
The product is an email-address reachability checker, available as a Rust library, a direct-running CLI, and an HTTP backend. Its core workflow parses and normalizes an address, checks DNS/MX, probes the mail provider over SMTP or provider-specific methods, gathers metadata, and classifies reachability. The backend also exposes synchronous and bulk APIs, with queued work, throttling, persistence, and optional webhook delivery. Several bulk and provider-specific implementations are unsampled, so their internal links are omitted or marked unverified.
Main entry points: lib.rs Library API · do_work.rs Work processor · mod.rs HTTP routing · bulk Bulk API
Components 23
Clients
- CLI
cli/src/main.rs - Library API
core/src/lib.rs
Email verification
- Syntax checks
core/src/syntax/mod.rs - MX lookup
core/src/mx/mod.rs - SMTP verification
core/src/smtp/connect.rs - Provider methods
core/src/smtp/mod.rs - SMTP response parsing
core/src/smtp/parser.rs - Address metadata
core/src/misc/mod.rs - Breach lookup
core/src/haveibeenpwned.rs - Result model
core/src/util/input_output.rs
HTTP backend
- HTTP routing
backend/src/http/mod.rs - Single-check API
backend/src/http/v0/check_email/post.rs - Bulk API
backend/src/http/v0/bulk - Version 1 API
backend/src/http/v1 - Backend config
backend/src/config.rs
Async operations
- Queue consumer
backend/src/worker/consume.rs - Work processor
backend/src/worker/do_work.rs - Request throttling
backend/src/throttle.rs - Postgres storage
backend/src/storage/postgres.rs - Bulk results
backend/src/http/v0/bulk/results/mod.rs - SQS worker
sqs/src/main.rs
Other components
- CLI user
- API client
Connections 29
- CLI user → CLI: runs
README.md - CLI → Library API: checks email
README.md - API client → HTTP routing: sends requests
README.md - HTTP routing → Single-check API: routes to
backend/src/http/mod.rs - HTTP routing → Bulk API: routes to
backend/src/http/mod.rs - HTTP routing → Version 1 API: routes to
backend/src/http/mod.rs - Single-check API → Library API: calls check
backend/src/http/v0/check_email/post.rs - Library API → Syntax checks: checks syntax
core/src/lib.rs - Library API → MX lookup: checks MX
core/src/lib.rs - Library API → SMTP verification: verifies mailbox
core/src/lib.rs - Library API → Address metadata: gathers metadata
core/src/lib.rs - Library API → Result model: returns result
core/src/lib.rs - MX lookup → Syntax checks: uses domain
core/src/mx/mod.rs - SMTP verification → Provider methods: dispatches methods
core/src/smtp/mod.rs - SMTP verification → SMTP response parsing: parses responses
core/src/smtp/connect.rs - Address metadata → Breach lookup: optionally checks
core/src/misc/mod.rs - Address metadata → Syntax checks: uses address details
core/src/misc/mod.rs - Version 1 API → Work processor: dispatches work
backend/src/http/v1/check_email/post.rs - Version 1 API → Request throttling: checks limits
backend/src/http/v1/check_email/post.rs - Backend config → Postgres storage: configures adapter
backend/src/config.rs - Backend config → Request throttling: configures limits
backend/src/config.rs - Queue consumer → Work processor: processes messages
backend/src/worker/consume.rs - Work processor → Library API: checks email
backend/src/worker/do_work.rs - Work processor → Postgres storage: stores results
backend/src/worker/do_work.rs - Work processor → Request throttling: checks capacity
backend/src/worker/do_work.rs - Bulk API → Postgres storage: uses job storage
- Bulk API → Queue consumer: submits jobs
- Bulk API → Bulk results: serves results
backend/src/http/v0/bulk/results/mod.rs - SQS worker → Work processor: dispatches work