Skip to content

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.

API response fields
FieldTypeDescription
ResultstringOverall verdict: "deliverable", "risky", "undeliverable", or "unknown".
ReasonstringWhy the verdict was reached — e.g. "accepted_email", "invalid_domain", "email_disabled", "low_quality".
RolebooleanTrue when the address is role-based (info@, admin@, sales@) rather than personal.
FreebooleanTrue when the domain is a free mailbox provider (Gmail, Yahoo…).
DisposablebooleanTrue when the address belongs to a temporary/throwaway service.
SpamtrapbooleanTrue when the address matches a known spam trap pattern.
Did_you_meanstring | nullSuggested correction when a typo is detected — e.g. "[email protected]" for gmial.com.
UserstringThe local part of the address (before the @).
DomainstringThe domain part of the address (after the @).
EmailstringThe 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