Real-Time Verification API
Catch bad emails before they reach your list
Visitors mistype. Bots register. Throwaway addresses pile up. With the ELV API at your signup box, sketchy emails are spotted at the point of entry — typos get corrected, fakes get rejected, and only valid contacts enter your database.
Why real-time
Connect with real people, automatically
If you're swamped with shady signups, it's time for a preemptive solution. With the ELV API in place, you can:
Monitor whatever gets typed — no manual supervision
Spot typos in emails and suggest corrections instantly
Collect only genuine, deliverable contacts
Thwart fake registration attempts
Ban bots and fake profiles on the spot
Stay informed about the domains your leads use
Quick start
One GET request to verify any address
Grab your API key from the dashboard and you're live. Sub-second responses, JSON in and out, with a did-you-mean suggestion when the user fat-fingers their domain.
Keep your API key server-side — proxy the call through your backend rather than embedding the key in client code.
curl "https://app.emaillistvalidation.com/api/verifEmail\
?secret=YOUR_API_KEY&[email protected]"Bulk endpoint
Verify entire files programmatically
Upload a file, keep the returned file ID, then poll for status or register a webhook. Results come back segmented and ready to download.
# 1. Upload a file for bulk verification
curl -X POST \
"https://apps.emaillistvalidation.com/api/verifApiFile\
?secret=YOUR_API_KEY&filename=my_emails.txt" \
-F "file_contents=@/path/to/emails.txt"
# → returns a FILE_ID — keep it
# 2. Poll status / get the download link when finished
curl "https://apps.emaillistvalidation.com/api/getApiFileInfo\
?secret=YOUR_API_KEY&id=FILE_ID"Response reference
Every field, explained
A single verification returns the verdict plus every risk signal we detected — so your application can apply exactly the policy you want.
| Field | Type | Description |
|---|---|---|
| Result | string | Overall verdict: "deliverable", "risky", "undeliverable", or "unknown". |
| Reason | string | Why the verdict was reached — e.g. "accepted_email", "invalid_domain", "email_disabled", "low_quality". |
| Role | boolean | True when the address is role-based (info@, admin@, sales@) rather than personal. |
| Free | boolean | True when the domain is a free mailbox provider (Gmail, Yahoo…). |
| Disposable | boolean | True when the address belongs to a temporary/throwaway service. |
| Spamtrap | boolean | True when the address matches a known spam trap pattern. |
| Did_you_mean | string | null | Suggested correction when a typo is detected — e.g. "[email protected]" for gmial.com. |
| User | string | The local part of the address (before the @). |
| Domain | string | The domain part of the address (after the @). |
| string | The full normalized email address that was verified. |
Why developers pick ELV
Things to love about the API
Exceptional accuracy
Addresses are inspected as they're entered. Invalid domains, spam content, and other hard-bounce signals can't get past the API's protective layers in 99% of cases.
Custom functions
Adjust the API to your inputs: detect nonsense entries, block fake registrations, suggest typo corrections — or all three at once.
Works everywhere
Software, mobile app, or Contact Us page — the API speaks standard HTTPS and JSON, so every stack and language is at home with it.
One credit pool
API calls draw from the same credits as dashboard verifications — same volume discounts, and credits never expire.
Bulk + webhooks
Push entire files through the bulk endpoint and get notified via webhook the moment segmented results are ready to download.
Guaranteed results
The same 100% money-back guarantee that covers dashboard cleaning covers every API verification too.
Verifying at the point of entry keeps new signups clean. For the contacts already in your database, pair the API with bulk list cleaning or automated CRM cleaning. Evaluating API providers? See how we compare to Emailable.
API FAQ
Common questions
Most verifications return in well under a second. Addresses behind greylisting are automatically retried by our anti-greylisting technology rather than being misclassified.
Yes. For bulk file verifications you can poll getApiFileInfo or register a webhook to be notified the moment processing finishes, including a download link for the segmented results.
The API comfortably handles production signup traffic; our infrastructure verifies over 100,000 emails per hour per customer. If you expect sustained bursts beyond that, contact us and we'll provision capacity.
API verifications draw from the same credit pool as dashboard verifications — one credit per email, with the same volume discounts. Credits never expire.
Integrate today — don't fumble your lists
Sign up, grab your key, and get 100 free credits to fuel a smooth start. Hard bounces and non-existent addresses stop here.
80,000+ users · 4.8/5 from 400+ reviews