Skip to main content
POST
/
email-finder
Email Finder
curl --request POST \
  --url https://api.leadmagic.io/email-finder \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "first_name": "Bill",
  "last_name": "Gates",
  "domain": "microsoft.com",
  "company_name": "Microsoft"
}'
{
  "email": "jesse@leadmagic.io",
  "status": "valid",
  "credits_consumed": 1,
  "message": "Valid email found.",
  "first_name": "Jesse",
  "last_name": "Ouellette",
  "domain": "leadmagic.io",
  "is_domain_catch_all": false,
  "mx_record": "alt3.aspmx.l.google.com",
  "mx_provider": "Google Workspace",
  "mx_security_gateway": false,
  "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_linkedin_url": "linkedin.com/company/leadmagichq",
  "company_linkedin_id": "75153174",
  "company_facebook_url": "",
  "company_twitter_url": "",
  "company_type": "private"
}

​
Email Finder Status Codes

You MUST put in the Company Domain or Company Name. Company Domain is always more accurate.

​
Input Example

You MUST use one of them:
  • Company Domain: leadmagic.io (more accurate and preferred)
  • Company Name: LeadMagic (less accurate)

​
Status Codes

​
Valid Email Address (Priority #1) - High Quality

Status: validDescription: The email response was given and is 100% valid.Action: Always email. Low bounce rate < 1%.Always Tested. Always a result of a mail-server validation.

​
Valid Catch All Email Address (Priority #2) - Lower Quality

Status: valid_catch_allDescription: The email has been given a Valid Catch All (Accept All) status because we’ve discovered engagement information on it. It should be considered to be sent to at a lower volume or secondary to the valids which were confirmed by the email server.Action: Send as a second priority. Higher bounce rate to be expected. 3-5%.Caution: Do not email these with newer domains or without warm-up or prior campaigns.

​
Catch All Email Address (Risky) - Avoid

Status: catch_allDescription: The domain sends only Catch All (Accept All) emails back and requires further validation.Action: Validate with CatchAll Verification. Very risky to email. No guarantee of response or delivery.

​
Not Found (No Email Address Found)

Status: not_foundDescription: The email response was catch-all, but engagement data shows the email is valid.Action: Email.
You must provide either the Company Domain Name or the Company Name in your POST request.

​
Security Gateway Information

​
Secure Email Gateway Detection by LeadMagic

LeadMagic has taken a necessary step in helping people leveraging email addresses for the purposes of Email Marketing or Cold Email.By detecting MX Records + Manufacturer of the MX Server Software, LeadMagic is able to provide you a deeper analysis of the chances of landing in the primary inbox for that domain.On-top of that we provide you with a base company record to understand the impact of Size & MX Record of a Company and your overall reply rates in your campaigns.

​
Rate Limit

Rate Limit on Email Finder: 400 requests per minute.
Contact our support team if you need to increase your requests per minute.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
first_name
string
default:Bill

Provide the First Name

​
last_name
string | null
default:Gates

Provide the Person's Last Name (Optional)

​
domain
string
default:microsoft.com

Provide the Company Domain Name (Optional)

​
company_name
string
default:Microsoft

Provide the Company Name (Optional)

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"

​
is_domain_catch_all
boolean
Example:

false

​
mx_record
string
Example:

"alt3.aspmx.l.google.com"

​
mx_provider
string
Example:

"Google Workspace"

​
mx_security_gateway
boolean
Example:

false

​
company_name
string
Example:

"Leadmagic"

​
company_industry
string
Example:

""

​
company_size
string
Example:

"11-50"

​
company_founded
integer
Example:

2022

​
company_location
object
​
company_linkedin_url
string
Example:

"linkedin.com/company/leadmagichq"

​
company_linkedin_id
string
Example:

"75153174"

​
company_facebook_url
string
Example:

""

​
company_twitter_url
string
Example:

""

​
company_type
string
Example:

"private"