Help & Knowledge Hub
Everything you need to go from your first verification to bulk-cleaning whole lists — quick start, feature map, and answers to the questions we get most. Still stuck? Email hello@emailguard.dev.
Quick start
Verify your first email on the homepage
Type any address into the demo box on the homepage and hit Verify. You get the same result the API returns: a 0–100 score, a deliverability status, and the individual checks (syntax, MX, SPF, DMARC, disposable, role, blacklist). No account needed for the demo.
Get your API key
Sign up at /signup for a free key (100 verifications per month, no credit card), or redeem a lifetime-deal coupon at /redeem — a coupon activates Enterprise-level access on a brand-new key. Your key starts with eg_ and is shown once at creation, so store it somewhere safe.
Call the API
Send your key in the X-API-Key header (or as Authorization: Bearer). One GET does it: curl "https://emailguard.dev/api/v1/verify?email=test@example.com" -H "X-API-Key: eg_your_key". POST with a JSON body {"email": "..."} works too.
Read the score and checks
status buckets the 0–100 score: deliverable (80+), risky (50–79), undeliverable (below 50). The checks object tells you WHY — no MX records, disposable domain, role account, catch-all provider, missing SPF/DMARC — and blacklist reports whether the domain sits on the Spamhaus DBL. The reason field summarizes it in one sentence.
Scale up to bulk
On Premium and above you can POST up to 100 addresses at once as a JSON array to /api/v1/verify, or upload a whole CSV (any column layout, up to 1,000 unique addresses per call) to /api/v1/verify/csv. Export your request history from the dashboard as JSON or CSV any time.
Features & API map
| Feature | Plan | API |
|---|---|---|
| Single email verification | All plans (Free included) | GET/POST /api/v1/verify |
| Bulk verify (JSON array, ≤100) | Premium+ | POST /api/v1/verify |
| Bulk verify (CSV upload, ≤1,000) | Premium+ | POST /api/v1/verify/csv |
| Blacklist (Spamhaus DBL) check | All plans — included in every result | blacklist field of /api/v1/verify |
| Email provider detection | Premium+ | GET /api/v1/provider |
| Domain posture monitoring (MX/SPF/DMARC alerts) | Premium+ (25 / 100 / 250 domains) | /api/v1/monitors |
| Webhook callbacks (HMAC-signed) | Premium+ | /api/v1/webhooks |
| Embeddable SVG badge | Public — no key needed | GET /api/badge |
| Request history export (JSON/CSV) | All plans | GET /api/dashboard/requests |