Email API
Email Verifier
Verify any email address before you send — SMTP and MX checks, deliverability status, and a 0–100 quality score.
POST
$0.01/call/v1/email/verifyUsage
const res = await fetch('https://api.yepapi.com/v1/email/verify', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ email: '[email protected]' }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/email/verify \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]"}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
email | string | Yes | Email address to verify | — |
Response
{
"data": {
"checks": {
"acceptAll": false,
"blocked": false,
"disposable": false,
"gibberish": false,
"greylisted": false,
"mx": true,
"smtp": true,
"smtpServer": true,
"validFormat": true,
"webmail": false
},
"deliverability": "undeliverable",
"email": "[email protected]",
"mxRecords": [
"aspmx.l.google.com",
"alt1.aspmx.l.google.com",
"alt2.aspmx.l.google.com",
"aspmx2.googlemail.com",
"aspmx3.googlemail.com"
],
"score": 12,
"smtpProvider": "Google Workspace",
"sources": [],
"status": "invalid"
},
"ok": true
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.email | string | The email address that was verified |
data.status | string | Overall verification result — valid, invalid, or unknown |
data.deliverability | string | Deliverability assessment — deliverable, undeliverable, or risky |
data.score | number | Quality score from 0 (bad) to 100 (safe to send) |
data.checks | object | Individual verification checks |
data.checks.validFormat | boolean | Whether the address is syntactically valid |
data.checks.mx | boolean | Whether the domain has MX records |
data.checks.smtp | boolean | Whether the mailbox responded to the SMTP check |
data.checks.smtpServer | boolean | Whether an SMTP server was reachable |
data.checks.acceptAll | boolean | Whether the domain accepts all incoming mail (catch-all) |
data.checks.disposable | boolean | Whether the address is a disposable/temporary email |
data.checks.webmail | boolean | Whether the address is a webmail account (e.g., Gmail) |
data.checks.gibberish | boolean | Whether the local part looks like random characters |
data.checks.greylisted | boolean | Whether the server greylisted the verification attempt |
data.checks.blocked | boolean | Whether the server blocked the verification attempt |
data.mxRecords | string[] | MX records found for the domain |
data.smtpProvider | string | null | Detected mail provider (e.g., Google Workspace) |
data.sources | object[] | Public web pages where the email was found |
Under the Hood
A high score with deliverability: "deliverable" means the address is safe to send to. greylisted or blocked checks may cause a status of unknown — retrying later often resolves it.