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",
  "domain": "leadmagic.io"
}
'
{
  "email": "jesse.ouellette@leadmagic.io",
  "status": "valid",
  "credits_consumed": 1,
  "message": "Email was confidently found and verified.",
  "first_name": "Jesse",
  "last_name": "Ouellette",
  "domain": "leadmagic.io",
  "mx_record": "alt3.mx1.example.com",
  "mx_provider": "Example Mail",
  "mx_security_gateway": false,
  "has_mx": true,
  "mx_records_full": [
    {
      "priority": 10,
      "exchange": "mx1.example.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 valid email found
No ResultsFREE if no email found (null)
You only pay when we find a valid email. If no email is found (status null), you are not charged.

​
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": "Jesse",
    "last_name": "Ouellette",
    "domain": "leadmagic.io"
  }'

​
Request Parameters

​
first_name
string
Person’s first name. Required if full_name not provided. If both are sent, first_name + last_name are used first.
​
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. Leave this field out when sending split names.
​
domain
string
Company website domain (preferred). More accurate than company_name; if both are sent, domain is used first.
​
company_name
string
Company name. Use only 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
Result status: valid or null
​
credits_consumed
number
required
Credits used (1 for valid, 0 for null)
​
message
string
required
Human-readable status message
​
employment_verified
boolean
Whether employment at this company was verified

​
Example Responses

{
  "email": "jesse.ouellette@leadmagic.io",
  "status": "valid",
  "credits_consumed": 1,
  "message": "Valid email found.",
  "first_name": "Jesse",
  "last_name": "Ouellette",
  "domain": "leadmagic.io",
  "mx_provider": "Example Mail",
  "employment_verified": true,
  "company_name": "LeadMagic",
  "company_industry": "Technology"
}

​
Status Codes

valid

1 credit - Email immediatelyVerified email found. Safe to send.

null

FREE - No email foundNo email found for this person at this company. Not charged.

​
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.
If the result is null, try variations: different name spellings, company domain instead of name, or full_name instead of first_name/last_name.

​
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

First name of the person. If both split names and full_name are sent, first_name + last_name are used first.

Example:

"Jesse"

​
last_name
string | null

Last name of the person. Send with first_name when available.

Example:

"Ouellette"

​
full_name
string | null

Full name of the person. Alternative to first_name + last_name; omit when sending split names.

Example:

"Jesse Ouellette"

​
domain
string

Company domain name. Preferred over company_name; if both are sent, domain is used first.

Example:

"leadmagic.io"

​
company_name
string

Company name. Use only if domain is not available.

Example:

"LeadMagic"

Response

Successful response with email details

​
email
string | null
Example:

"jesse.ouellette@leadmagic.io"

​
status
string | null
Example:

"valid"

​
credits_consumed
integer
Example:

1

​
message
string
Example:

"Email was confidently found and verified."

​
first_name
string
Example:

"Jesse"

​
last_name
string
Example:

"Ouellette"

​
domain
string
Example:

"leadmagic.io"

​
mx_record
string
Example:

"alt3.mx1.example.com"

​
mx_provider
string
Example:

"Example Mail"

​
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