POST
/
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: valid

Description: 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_all

Description: 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_all

Description: 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_found

Description: 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

Response

200
application/json

Successful response with email details

The response is of type object.