Email API
Phone Finder
Find a contact's phone number from an email address, domain, or LinkedIn profile — with formats, line type, and timezone.
POST
$0.05/call/v1/email/phone-finderUsage
const res = await fetch('https://api.yepapi.com/v1/email/phone-finder', {
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/phone-finder \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]"}'Request Body
Provide exactly one of email, domain, or linkedin.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
email | string | One of | Email address to find a phone number for | — |
domain | string | One of | Company domain to find a phone number for | — |
linkedin | string | One of | LinkedIn profile URL to find a phone number for | — |
Response
{
"data": {
"carrier": null,
"countryCode": "US",
"domain": "stripe.com",
"e164Format": "+13015882564",
"email": "[email protected]",
"intlFormat": "+1 301-588-2564",
"lineType": "FIXED_LINE_OR_MOBILE",
"localFormat": "(301) 588-2564",
"timezones": [
"America/New_York"
],
"valid": true
},
"ok": true
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.valid | boolean | Whether the phone number found is valid |
data.e164Format | string | Number in E.164 format (e.g., +13015882564) |
data.intlFormat | string | Number in international display format |
data.localFormat | string | Number in national/local display format |
data.countryCode | string | ISO country code of the number |
data.lineType | string | Line type (e.g., FIXED_LINE_OR_MOBILE, MOBILE) |
data.carrier | string | null | Carrier name, when known |
data.timezones | string[] | IANA timezones associated with the number |
data.email | string | null | The email the lookup was based on, when provided |
data.domain | string | null | The domain associated with the contact |
Under the Hood
Use timezones to schedule calls at a reasonable local hour. To validate a number you already have, use the cheaper Phone Validator.