Email Validator
Validate an email address and get back a full quality signal: syntax, DNS, MX, disposable check, role account detection, and a quality score.
⚡ 2 credits per call
Try it
Fill in the fields below and hit Send.
Why use this
Agents don't just want valid/invalid. They want to decide: should I contact this person? Is this a real person or a bot? Is this address worth the effort?
One call runs all checks and returns a structured signal.
Pricing
| Any email | 2 credits |
|---|
Request format
{ "email": "[email protected]" }
| Field | Type | Notes |
|---|---|---|
email |
string | Required. Must be a valid email format. |
Response
{
"email": "[email protected]",
"valid": true,
"syntax": true,
"dns": true,
"mx": true,
"role_account": false,
"disposable": false,
"free_provider": false,
"domain_type": "corporate",
"domain_age_days": 3200,
"score": 0.93
}
| Field | Type | Notes |
|---|---|---|
valid |
boolean | true only if syntax, DNS, and MX all pass |
syntax |
boolean | Basic format check |
dns |
boolean | Domain resolves in DNS |
mx |
boolean | Domain has mail exchange records |
role_account |
boolean | Local part is a role address (admin, support, sales…) |
disposable |
boolean | Domain is a known throwaway provider |
free_provider |
boolean | Domain is a known free email provider (Gmail, Yahoo…) |
domain_type |
string | "disposable" | "free" | "corporate" | "unknown" |
domain_age_days |
number | null | Days since domain registration. null if WHOIS unavailable. |
score |
number | 0–1 quality signal. 1 = strong signal of a real address. |
Score
Starts at 1.0. Deductions:
| Signal | Deduction |
|---|---|
| Syntax / DNS / MX fail | → 0 immediately |
| Disposable domain | −0.4 |
| Role account | −0.2 |
| Free provider | −0.1 |
| Domain age < 30 days | −0.2 |
| Domain age 30–364 days | −0.1 |
| Domain age unknown | −0.05 |
Errors (400, no charge)
| Error | Cause |
|---|---|
Email is required |
Empty email field |
| Zod validation error | Invalid email format |
API Reference
Endpoint
POST https://api.lightningapi.tools/email-validator/validate
Required headers
Authorization: Bearer <apiKey>
Content-Type: application/json
Example request
{
"email": "[email protected]"
}
Example response
{
"email": "[email protected]",
"valid": true,
"syntax": true,
"dns": true,
"mx": true,
"role_account": false,
"disposable": false,
"free_provider": false,
"domain_type": "corporate",
"domain_age_days": 3200,
"score": 0.93
}