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": "Bill",
  "last_name": "Gates",
  "domain": "microsoft.com",
  "company_name": "Microsoft"
}
'

{
  "email": "[email protected]",
  "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"
}

POST

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": "Bill",
  "last_name": "Gates",
  "domain": "microsoft.com",
  "company_name": "Microsoft"
}
'

{
  "email": "[email protected]",
  "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

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

string

Example:

"[email protected]"

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

Show child attributes

company_location.name

string

Example:

"boston, massachusetts, united states"

company_location.locality

string

Example:

"boston"

company_location.region

string

Example:

"massachusetts"

company_location.metro

string

Example:

"boston, massachusetts"

company_location.country

string

Example:

"united states"

company_location.continent

string

Example:

"north america"

company_location.street_address

string

Example:

"1 seaport lane"

company_location.address_line_2

string

Example:

null

company_location.postal_code

string

Example:

"02210"

company_location.geo

string

Example:

"42.35,-71.06"

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"

Email Validation Profile Search

⌘I

Credits

People Enrichment

Company Enrichment

Jobs Data

Ads Data

Email Finder

Email Finder Status Codes

Input Example

Status Codes

Valid Email Address (Priority #1) - High Quality

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

Catch All Email Address (Risky) - Avoid

Not Found (No Email Address Found)

Security Gateway Information

Secure Email Gateway Detection by LeadMagic

Rate Limit

Authorizations

Body

Response

Credits

People Enrichment

Company Enrichment

Jobs Data

Ads Data

​Email Finder Status Codes

​Input Example

​Status Codes

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

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

​Catch All Email Address (Risky) - Avoid

​Not Found (No Email Address Found)

​Security Gateway Information

​Secure Email Gateway Detection by LeadMagic

​Rate Limit

Authorizations

Body

Response

Email Finder Status Codes

Input Example

Status Codes

Valid Email Address (Priority #1) - High Quality

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

Catch All Email Address (Risky) - Avoid

Not Found (No Email Address Found)

Security Gateway Information

Secure Email Gateway Detection by LeadMagic

Rate Limit