Email verification API
Real-Time Email Verification API
Validate email addresses during signup, checkout, lead capture, and data import using syntax, domain, MX, mailbox, disposable, role-based, and accept-all signals.
curl "https://api.ValidEmail.net/?email=user@example.com&token=YOUR_API_KEY"
{
"IsValid": true,
"Score": 95,
"Email": "user@example.com",
"State": "Deliverable",
"Reason": "ACCEPTED EMAIL",
"Domain": "example.com",
"Free": false,
"Role": false,
"Disposable": false,
"AcceptAll": false,
"Tag": false,
"MXRecord": "mx.example.com.",
"RetryAfterSeconds": null,
"EmailAdditionalInfo": []
}
Use cases
Verify emails where bad data enters your product.
Use ValidEmail in forms, imports, CRM workflows, and onboarding systems before invalid contacts create support, deliverability, or fraud costs.
Signup validation
Check addresses before account creation or email confirmation steps.
Checkout validation
Reduce order issues caused by typoed or temporary mailbox addresses.
Lead forms
Improve lead quality before sending records to sales or marketing tools.
CRM enrichment
Add score, state, reason, domain, and risk flags to contact records.
CSV imports
Validate imported addresses before they enter customer workflows.
Fraud reduction
Flag disposable, role-based, accept-all, and low-confidence addresses.
Capabilities
Return the fields developers need for decisions.
Build simple rules with `IsValid`, `Score`, `State`, and `Reason`, then refine with disposable, role, accept-all, free-provider, domain, tag, and MX details.
Syntax and domain checks
Catch malformed emails and domain-level issues early.
MX and mailbox signals
Inspect mail-exchange and recipient-level deliverability signals.
Disposable detection
Identify temporary mailbox providers.
Role detection
Flag shared inboxes such as info, admin, support, and sales.
Accept-all detection
Know when a domain makes mailbox certainty limited.
Score and reason
Use numeric confidence plus a readable reason for routing logic.
Integration examples
Start with cURL, then move to your stack.
Full language guides are available in the documentation. These compact examples show the production endpoint shape.
const email = "user@example.com";
const token = "YOUR_API_KEY";
const url = `https://api.ValidEmail.net/?email=${encodeURIComponent(email)}&token=${token}`;
const response = await fetch(url);
const result = await response.json();
console.log(result.IsValid, result.Score, result.State);
import requests
params = {"email": "user@example.com", "token": "YOUR_API_KEY"}
response = requests.get("https://api.ValidEmail.net/", params=params, timeout=15)
result = response.json()
print(result["IsValid"], result["Score"], result["State"])
Performance and limits
Predictable API behavior for production workflows.
Authentication
Pass your API key as the `token` query parameter.
Rate limits
Limits are enforced per API key. A rate-limited request returns HTTP 429 with a readable error.
Timeouts
Client libraries should set a timeout and retry only when the failure is temporary.
Temporary SMTP outcomes
Some results can include `RetryAfterSeconds` when retrying later may produce a more final result.
Credits
A standard verification uses one credit. Requests without enough credits return an error.
Versioning
The current documented real-time endpoint is `https://api.ValidEmail.net/`, with a `/v2` route also present for newer API behavior.
API pricing
Email verification API credits for production workflows.
Buy the credit package that matches your launch volume, then use the same credits for real-time API checks, bulk uploads, and integrations.
Credits
5,000
API verifications$1.90
final price after discount$0.00038 per credit after discount
- Instant access to API credits
- Use for API, bulk, or integrations
- Credits never expire
No subscription. No hidden fees.
Credits
10,000
API verifications$3.00
final price after discount$0.0003 per credit after discount
- Instant access to API credits
- Use for API, bulk, or integrations
- Credits never expire
No subscription. No hidden fees.
Credits
25,000
API verifications$7.05
final price after discount$0.000282 per credit after discount
- Instant access to API credits
- Use for API, bulk, or integrations
- Credits never expire
No subscription. No hidden fees.
Credits
50,000
API verifications$12.25
final price after discount$0.000245 per credit after discount
- Instant access to API credits
- Use for API, bulk, or integrations
- Credits never expire
No subscription. No hidden fees.
Credits
100,000
API verifications$21.00
final price after discount$0.00021 per credit after discount
- Instant access to API credits
- Use for API, bulk, or integrations
- Credits never expire
No subscription. No hidden fees.
Credits
200,000
API verifications$42.00
final price after discount$0.00021 per credit after discount
- Instant access to API credits
- Use for API, bulk, or integrations
- Credits never expire
No subscription. No hidden fees.
Credits
500,000
API verifications$100.00
final price after discount$0.0002 per credit after discount
- Instant access to API credits
- Use for API, bulk, or integrations
- Credits never expire
No subscription. No hidden fees.
Credits
1,000,000
API verifications$200.00
final price after discount$0.0002 per credit after discount
- Instant access to API credits
- Use for API, bulk, or integrations
- Credits never expire
No subscription. No hidden fees.
Credits
5,000,000
API verifications$900.00
final price after discount$0.00018 per credit after discount
- Instant access to API credits
- Use for API, bulk, or integrations
- Credits never expire
No subscription. No hidden fees.
Credits
10,000,000
API verifications$1,600.00
final price after discount$0.00016 per credit after discount
- Instant access to API credits
- Use for API, bulk, or integrations
- Credits never expire
No subscription. No hidden fees.
Credits
20,000,000
API verifications$2,000.00
final price after discount$0.0001 per credit after discount
- Instant access to API credits
- Use for API, bulk, or integrations
- Credits never expire
No subscription. No hidden fees.
Credits
40,000,000
API verifications$2,700.00
final price after discount$0.0000675 per credit after discount
- Instant access to API credits
- Use for API, bulk, or integrations
- Credits never expire
No subscription. No hidden fees.
Developer trust
Clear docs beat decorative badges.
Use the linked docs for endpoint examples, response fields, and implementation details. Contact support for account-specific limits or enterprise-volume needs.
Documentation
API guide, response reference, and language examples.
Error guidance
Handle invalid tokens, credit errors, rate limits, and temporary network failures explicitly.
Privacy information
Review the published Privacy Policy for data handling details.
Support channel
Reach ValidEmail through the contact page for implementation help.
FAQ
Email Verification API questions.
How does the API verify an email?
It uses syntax, domain, MX, mailbox, disposable, role-based, accept-all, and related deliverability signals.
Which fields are returned?
IsValid, Score, Email, State, Reason, Domain, Free, Role, Disposable, AcceptAll, Tag, MXRecord, RetryAfterSeconds, and EmailAdditionalInfo.
What are the rate limits?
Rate limits are configured per API key. If a request is limited, the API returns HTTP 429.
How are timeouts handled?
Your client should set a timeout and retry temporary failures according to your product's tolerance.
How are temporary SMTP responses handled?
When applicable, `RetryAfterSeconds` can indicate when to re-query for a more final result, including temporary greylisting responses.
What does accept-all mean?
The domain accepts recipient checks broadly, so mailbox certainty is limited.
Does verification send an email?
No. The API checks deliverability signals without sending an email to the address.
How are credits charged?
A standard API verification uses one credit. View pricing for current packages and terms.
Is there a sandbox?
Use your account API key and a small test set. Contact support if you need a dedicated test arrangement.
Which languages are supported?
Any language that can send HTTPS requests. Docs include C#, Python, PHP, JavaScript, Java, Go, and Ruby.
Add Email Verification to Your Application
Create an account, get your API key, and start validating signup, checkout, lead, and import workflows.