Email API
Email Enrichment
Turn any email address into a full contact profile — name, company, location, social links, and verification status.
POST
$0.02/call/v1/email/enrichUsage
const res = await fetch('https://api.yepapi.com/v1/email/enrich', {
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/enrich \
-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 enrich | — |
Response
{
"data": {
"contact": {
"acceptAll": true,
"company": "Stripe",
"companyDomain": "stripe.com",
"confidenceScore": 26,
"country": "US",
"department": null,
"disposable": false,
"email": "[email protected]",
"firstName": "Matthew",
"fullName": "Matthew Yalowitz",
"gender": "male",
"hasPhone": true,
"lastName": "Yalowitz",
"linkedin": "https://www.linkedin.com/in/myalowitz",
"position": null,
"seniority": null,
"sources": [],
"twitter": null,
"type": "personal",
"verificationStatus": "invalid",
"verified": false,
"webmail": false
}
},
"ok": true
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.contact | object | The enriched contact profile |
data.contact.email | string | The email address that was enriched |
data.contact.firstName | string | null | First name |
data.contact.lastName | string | null | Last name |
data.contact.fullName | string | null | Full name |
data.contact.company | string | null | Company name |
data.contact.companyDomain | string | null | Company domain |
data.contact.position | string | null | Job title |
data.contact.department | string | null | Department |
data.contact.seniority | string | null | Seniority level |
data.contact.gender | string | null | Inferred gender |
data.contact.country | string | null | ISO country code |
data.contact.confidenceScore | number | Confidence score from 0 to 100 |
data.contact.type | string | null | personal or generic |
data.contact.verified | boolean | Whether the email has been verified as deliverable |
data.contact.verificationStatus | string | null | Verification result (e.g., valid, invalid) |
data.contact.acceptAll | boolean | Whether the mailbox domain is catch-all |
data.contact.disposable | boolean | Whether the address is a disposable email |
data.contact.webmail | boolean | Whether the address is a webmail account |
data.contact.hasPhone | boolean | Whether a phone number is available for this contact |
data.contact.linkedin | string | null | LinkedIn profile URL |
data.contact.twitter | string | null | Twitter/X profile URL |
data.contact.sources | object[] | Public web pages where the email was found |
Under the Hood
For a structured person/company breakdown of the same email, see Person Enrichment and Combined Enrichment.