Skip to main content
POST
/
email-validate
Email Validation
curl --request POST \
  --url https://api.leadmagic.io/email-validate \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "email": "jesse@leadmagic.io",
  "first_name": "Jesse",
  "last_name": "Ouellette"
}'
{
  "email": "jesse@leadmagic.io",
  "email_status": "valid",
  "credits_consumed": 0.05,
  "message": "Email is valid.",
  "is_domain_catch_all": false,
  "mx_record": "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 Verification Status Codes

​
Pricing PSA

LeadMagic’s Email Validation system is known for it’s high quality and low cost. For only 1 LeadMagic credit, you get 20 email validations. Plus, you will never pay for “catch_all” or “unknown” emails unless we have found engagement data which we believe makes it a valid email.

​
Update 5/18/2024

Our API has been updated to support “CatchAll” or “AcceptAll” email validation. We’ve built a scoring model and confidently believe our valid_catch_all emails are good to email. If you have any further questions please contact support.

​
Company Information 5/14/2024

We’ve updated our API to include the company’s domain and social media information at no cost to you.

​
Status Codes

​
👍 Always Email (1 Credit = 20 Validations)

valid ✅ (1 credit = 20 validations)
  • Description: The email response was given and is 100% valid.
  • Action: 100% Safe to Email. Very low bounce rates.

​
👍 Email Secondary (1 Credit = 20 Validations)

valid_catch_all ✅ (1 credit = 20 validations)
  • Description: The email response was catch-all, but additional “engagement” data shows the email is valid.
  • Action: Safe to email, but recognize there will be a <5% bounce rate.

​
🚧 Caution (0 Credits) - Always Free

catch_all ✋ 🆓 (always free)
  • Description: The domain accepts every email, making it risky. LeadMagic was not able to find enough evidence it’s a real email.
  • Action: Proceed with caution.
unknown
  • Description: The domain did not respond, making it risky. LeadMagic did not find enough evidence to email it.
  • Action: Proceed with caution.

​
❗️ Never Email (1 Credit = 20 Validations)

invalid 🛑 (1 credit = 20 validations)
  • Description: The email is not valid.
  • Action: Do not email.

​
Rate Limit

Rate Limit: 1000 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
​
email
string
default:jesse@leadmagic.io

Email address to validate

​
first_name
string
default:Jesse

First name of the person

​
last_name
string
default:Ouellette

Last name of the person

Response

200 - application/json

Successful validation

​
email
string
Example:

"jesse@leadmagic.io"

​
email_status
string
Example:

"valid"

​
credits_consumed
number
Example:

0.05

​
message
string
Example:

"Email is valid."

​
is_domain_catch_all
boolean
Example:

false

​
mx_record
string
Example:

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

⌘I