Skip to main content
POST
/
v1
/
people
/
email-finder
Email Finder
curl --request POST \
  --url https://api.leadmagic.io/v1/people/email-finder \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "first_name": "Jesse",
  "last_name": "Ouellette",
  "full_name": "Jesse Ouellette",
  "domain": "leadmagic.io",
  "company_name": "LeadMagic"
}
'
{
  "email": "jesse@leadmagic.io",
  "status": "valid",
  "credits_consumed": 1,
  "message": "Valid email found.",
  "first_name": "Jesse",
  "last_name": "Ouellette",
  "domain": "leadmagic.io",
  "mx_record": "alt3.aspmx.l.google.com",
  "mx_provider": "Google Workspace",
  "mx_security_gateway": false,
  "has_mx": true,
  "mx_records_full": [
    {
      "priority": 10,
      "exchange": "aspmx.l.google.com"
    }
  ],
  "company_name": "Leadmagic",
  "company_industry": "",
  "company_size": "11-50",
  "company_founded": 2022,
  "company_location": {
    "name": "boston, massachusetts, united states",
    "locality": "boston",
    "region": "massachusetts",
    "metro": "boston, massachusetts",
    "country": "united states",
    "continent": "north america",
    "street_address": "1 seaport lane",
    "address_line_2": null,
    "postal_code": "02210",
    "geo": "42.35,-71.06"
  },
  "company_profile_url": "leadmagichq",
  "company_profile_id": "75153174",
  "company_facebook_url": "",
  "company_twitter_url": "",
  "company_type": "private",
  "employment_verified": true
}

​
Find Work Email

Find professional email addresses from a person’s name and company. Every email found is automatically validated for deliverability.

​
Endpoint Details

MetricValue
Cost1 credit per email found
No ResultsFREE if no email found
You only pay when we successfully find an email. No-result lookups are always free.

​
Quick Example

curl -X POST 'https://api.leadmagic.io/v1/people/email-finder' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "domain": "company.com"
  }'

​
Request Parameters

​
first_name
string
Person’s first name. Required if full_name not provided.
​
last_name
string
Person’s last name. Required if full_name not provided.
​
full_name
string
Person’s full name. Alternative to first_name + last_name.
​
domain
string
Company website domain (preferred). More accurate than company_name.
​
company_name
string
Company name. Use if domain is not available.
You must provide at least one name field (first_name, last_name, or full_name) AND one company field (domain or company_name).

​
Response

​
email
string
The found email address (null if not found)
​
status
string
required
Validation status: valid, valid_catch_all, catch_all, not_found
​
credits_consumed
number
required
Credits used (1 if found, 0 if not)
​
message
string
required
Human-readable status message
​
employment_verified
boolean
Whether employment at this company was verified

​
Example Response

{
  "email": "john.doe@company.com",
  "status": "valid",
  "credits_consumed": 1,
  "message": "Valid email found.",
  "first_name": "John",
  "last_name": "Doe",
  "domain": "company.com",
  "mx_provider": "Google Workspace",
  "employment_verified": true,
  "company_name": "Company Inc",
  "company_industry": "Technology"
}

​
Status Codes

valid

1 credit - Email immediatelyVerified by mail server, <1% bounce rate.

valid_catch_all

1 credit - Safe to emailEngagement data proves validity, <5% bounce.

catch_all

1 credit - RiskyDomain accepts all, couldn’t verify specific address.

not_found

FREE - Try alternativesNo email found for this person at this company.

​
Best Practices

Domain lookups are more accurate. leadmagic.io will always find the right company, while “LeadMagic” might match similar names.
The employment_verified field tells you if we confirmed this person works at the company.
Send to valid emails first, then valid_catch_all, then consider catch_all with caution.
If not found, try variations: different name spellings, company domain instead of name, etc.

​
Use Cases

Sales Outreach

Find decision-maker emails for personalized outreach campaigns.

Lead Enrichment

Complete partial lead records with verified email addresses.

ABM Campaigns

Build contact lists for target accounts with verified emails.

Recruiting

Reach passive candidates with verified work emails.

Authorizations

​
X-API-Key
string
header
required

Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work).

Body

application/json
​
first_name
string
default:Jesse

First name of the person (optional if full_name provided)

​
last_name
string | null
default:Ouellette

Last name of the person (optional)

​
full_name
string | null
default:Jesse Ouellette

Full name of the person (alternative to first_name + last_name)

​
domain
string
default:leadmagic.io

Company domain name (required if company_name not provided)

​
company_name
string
default:LeadMagic

Company name (required if domain not provided)

Response

Successful response with email details

​
email
string
Example:

"jesse@leadmagic.io"

​
status
string
Example:

"valid"

​
credits_consumed
integer
Example:

1

​
message
string
Example:

"Valid email found."

​
first_name
string
Example:

"Jesse"

​
last_name
string
Example:

"Ouellette"

​
domain
string
Example:

"leadmagic.io"

​
mx_record
string
Example:

"alt3.aspmx.l.google.com"

​
mx_provider
string
Example:

"Google Workspace"

​
mx_security_gateway
boolean
Example:

false

​
has_mx
boolean

Whether the domain has MX records

Example:

true

​
mx_records_full
object[]

Complete list of MX records with priorities

​
company_name
string
Example:

"Leadmagic"

​
company_industry
string
Example:

""

​
company_size
string
Example:

"11-50"

​
company_founded
integer
Example:

2022

​
company_location
object
​
company_profile_url
string
Example:

"leadmagichq"

​
company_profile_id
string
Example:

"75153174"

​
company_facebook_url
string
Example:

""

​
company_twitter_url
string
Example:

""

​
company_type
string
Example:

"private"

​
employment_verified
boolean | null

Whether the employment at the domain was verified

Example:

true