Email Verification V2 (V3)

This Email Validation and Enrichment API is designed to provide comprehensive data on email addresses to help businesses ensure the quality and legitimacy of their contact lists. With this API, you can quickly validate email addresses, retrieve detailed information about the associated account, and get a full profile of the user behind the email. This includes the email’s validity status, domain information, and even personal and company details if available.

Key Features:

Email Validation: Checks whether an email address is valid, ensuring it's properly formatted and reachable.

Personal Profile Enrichment: Provides insights like name, bio, location, social media handles (such as LinkedIn), and more.

Domain Information: Retrieves the domain's age, SMTP provider, and MX records to verify its authenticity and reliability.

Company Details: Displays company-specific data, such as the company name, industry, phone numbers, and key business tags.

Fraud Prevention: Identifies free email providers (e.g., Gmail, Yahoo) to prevent fake or unreliable accounts from slipping through.

Use Case:

1. Customer Onboarding for Financial Institutions:

In sectors like banking and finance, ensuring that users are legitimate is a top priority. This API can be used to verify email addresses during the onboarding process to prevent fraud. By validating the email and retrieving company and personal information, financial institutions can confirm that users are authentic before moving forward with account creation, identity verification, and financial transactions.

2. Lead Scoring and Marketing Campaigns:

For companies running targeted email marketing campaigns, this API can be an essential tool to improve lead quality. Marketers can check the validity of email addresses before sending promotional emails, ensuring high deliverability and engagement rates. Moreover, personal and company data can be used to segment leads and tailor campaigns more effectively.

3. Compliance and Fraud Prevention in E-commerce:

For e-commerce platforms, email verification is crucial for preventing fake sign-ups and transactions. The API can quickly flag free or invalid emails, reducing the chances of fraud and ensuring that only verified customers are able to make purchases or access services.

4. Networking and Business Development:

For sales teams, knowing detailed information about a potential lead or partner can make a significant difference. The API’s ability to provide company and personal details associated with an email address allows sales teams to create more targeted outreach, improving their chances of building strong business relationships.

Overall, this Email Validation and Enrichment API is a versatile solution that can be applied across various industries, from finance and marketing to e-commerce and business development, helping businesses improve data quality, customer verification, and operational efficiency.

API details

Endpoint

POST https://api.signzy.app/api/v3/email/verificationV2

POST https://api-preproduction.signzy.app/api/v3/email/verificationV2

Request body parameters

Parameter	Data Type	Description	Required
emailId	String	The email address	Mandatory

{
    "emailId": "<Email id>"
}

Request Headers

Name	Value	Required	Description
Content-type	application/json	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Code Samples

curl --location 'https://api-preproduction.signzy.app/api/v3/email/verificationV2' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Authorization token>' \
--data '{
    "emailId": "<Email ID>"
}'

Response body parameters

Parameter	Data Type	Description
result	Object	The object containing the response of email verification.
result.emailId	String	The email ID.
result.validEmail	String	Indicates whether the email is valid (true/false).
result.status	String	The status of the email (e.g., valid).
result.subStatus	String	Any sub-status related to the email.
result.freeEmail	String	Indicates whether the email is a free email provider (true/false).
result.didYouMean	String	Suggests a correction if there's a possible misspelling in the email.
result.account	String	The account name associated with the email.
result.domain	String	The domain of the email address.
result.domainAgeDays	String	The age of the domain in days.
result.smtpProvider	String	The SMTP provider for the email.
result.mxFound	String	Indicates whether MX records were found for the domain (true/false).
result.mxRecord	String	The MX record associated with the domain.
result.personalDetails.name	String	The name associated with the email.
result.personalDetails.email	String	The email address.
result.personalDetails.location	String	The location of the individual.
result.personalDetails.timeZone	String	The time zone of the individual.
result.personalDetails.bio	String	Biography or personal description.
result.personalDetails.avatar	String	URL or reference to the individual's avatar.
result.personalDetails.employment	String	Employment details of the individual.
result.personalDetails.socialMediaHandles.facebook	String	Facebook handle.
result.personalDetails.socialMediaHandles.github	String	GitHub handle.
result.personalDetails.socialMediaHandles.twitter	String	Twitter handle.
result.personalDetails.socialMediaHandles.linkedin	String	LinkedIn handle.
result.personalDetails.socialMediaHandles.googleplus	String	Google Plus handle.
result.personalDetails.socialMediaHandles.aboutme	String	About Me handle.
result.personalDetails.socialMediaHandles.gravatar	String	Gravatar handle.
result.companyDetails.name	String	The name of the company associated with the email.
result.companyDetails.legalName	String	Legal name of the company.
result.companyDetails.domain	String	The domain associated with the company.
result.companyDetails.domainAliases	Array	Array of domain aliases, if any.
result.companyDetails.phoneNumbers	Array	Array of phone numbers associated with the company.
result.companyDetails.emailAddresses	Array	Array of email addresses associated with the company.
result.companyDetails.category.sector	String	Sector category of the company.
result.companyDetails.category.industryGroup	String	Industry group of the company.
result.companyDetails.category.industry	String	Industry of the company.
result.companyDetails.category.subIndustry	String	Sub-industry of the company.
result.companyDetails.category.sicCode	String	SIC code of the company.
result.companyDetails.category.naicsCode	String	NAICS code of the company.
result.companyDetails.tags	Array	Array of tags associated with the company.
result.companyDetails.description	String	Description of the company.
result.companyDetails.foundedYear	String	The year the company was founded.
result.companyDetails.location	String	Location of the company headquarters.
result.companyDetails.linkedinHandle	String	LinkedIn handle of the company.
result.companyDetails.usEIN	String	US Employer Identification Number (EIN) of the company.
result.companyDetails.metrics.alexaUsRank	String	Alexa ranking for the US.
result.companyDetails.metrics.alexaGlobalRank	String	Global Alexa ranking.
result.companyDetails.metrics.employeesRange	String	Range of employees in the company.
result.companyDetails.metrics.marketCap	String	Market capitalization of the company.
result.companyDetails.metrics.raised	String	Amount raised by the company.
result.companyDetails.metrics.annualRevenue	String	Annual revenue of the company.
result.companyDetails.metrics.estimatedAnnualRevenue	String	Estimated annual revenue of the company.
result.domainDetails.ip	String	IP address associated with the domain.
result.domainDetails.continentCode	String	Continent code where the domain is located.
result.domainDetails.countryCode	String	Country code where the domain is registered.
result.domainDetails.latitude	Number	Latitude coordinates of the domain location.
result.domainDetails.longitude	Number	Longitude coordinates of the domain location.
result.domainDetails.timezone	String	Timezone of the domain location.
result.domainDetails.domain	String	The domain name.
result.domainDetails.status	String	Status of the domain.
result.domainDetails.available	String	Availability status of the domain.
result.domainDetails.registered	String	Registration status of the domain.
result.domainDetails.domainId	String	Domain ID, if available.
result.domainDetails.createdOn	String	Date the domain was created.
result.domainDetails.updatedOn	String	Date the domain was last updated.
result.domainDetails.expiresOn	String	Expiry date of the domain.
result.domainDetails.registrar.id	String	Registrar ID, if available.
result.domainDetails.registrar.name	String	Registrar name.
result.domainDetails.registrar.organization	String	Registrar organization.
result.domainDetails.registrar.url	String	Registrar URL.
result.domainDetails.nameservers	Array	Array of nameservers associated with the domain.

{
    "error": {
        "reason": "Error From Upstream",
        "status": 409,
        "message": "Upstream Down",
        "type": "Conflict",
        "statusCode": 409,
        "name": "error"
    }
}

Status Code

DELIVERABILITY STATUS EXPLANATION

valid- These are emails that we determined to be valid and safe to email to, they will have a very low bounce rate of under 2%. If you receive bounces it can be because your IP might be blacklisted where our IP was not. Sometimes the email accounts exist, but they are only accepting mail from people in their contact lists. Sometimes you will get throttle on number of emails you can send to a specific domain per hour. It's important to look at the SMTP Bounce codes to determine why.

invalid- These are emails that we determined to be invalid, please delete them from your mailing list.

catch-all - These emails are impossible to validate without sending a real email and waiting for a bounce. The term Catch-all means that the email server tells you that the email is valid, whether it's valid or invalid. If you want to email these addresses, I suggest you segment them into a catch-all group and know that some of these will most likely bounce.

spamtrap- These emails are believed to be spamtraps and should not be mailed. We have technology in place to determine if certain emails should be classified as spamtrap. We don't know all the spamtrap email addresses, but we do know a lot of them.

abuse- These emails are of people who are known to click the abuse links in emails, hence abusers or complainers. We recommend not emailing these addresses.

do_not_mail- These emails are of companies, role-based, or people you just want to avoid emailing to. They are broken down into 6 sub-categories "disposable","toxic", "role_based", "role_based_catch_all", "global_suppression" and "possible_trap". Examine this file and determine if you want to email these address. They are valid email addresses, but shouldn't be mailed in most cases.

unknown- These emails we weren't able to validate for one reason or another. Typical cases are "Their mail server was down" or "the anti-spam system is blocking us". In most cases, 80% unknowns are invalid/bad email addresses.

We also provide a sub_status code to help explain some of the unknown and invalid results, not all unknowns and invalids will have sub_status codes.

SUB STATUS EXPLANATION

alias_address- (valid) These emails addresses act as forwarders/aliases and are not real inboxes, for example if you send an email to [email protected] and then the email is forwarded to [email protected]. It's a valid email address and you can send to them, it's just a little more information about the email address. We can sometimes detect alias email addresses and when we do we let you know.

antispam_system- (unknown) These emails have anti-spam systems deployed that are preventing us from validating these emails. You can submit these to us through the contact us screen to look into.

does_not_accept_mail- (invalid) These domains only send mail and don't accept it.

exception_occurred- (unknown) These emails caused an exception when validating. If this happens repeatedly, please let us know.

failed_smtp_connection- (unknown) These emails belong to a mail server that won't allow an SMTP connection. Most of the time, these emails will end up being invalid.

failed_syntax_check- (Invalid) Emails that fail RFC syntax protocols

forcible_disconnect- (Unknown) These emails belong to a mail server that disconnects immediately upon connecting. Most of the time, these emails will end up being invalid.

global_suppression- (do_not_mail) These emails are found in many popular global suppression lists (GSL), they consist of known ISP complainers, direct complainers, purchased addresses, domains that don't send mail, and known litigators.

greylisted- (Unknown) Emails where we are temporarily unable to validate them. A lot of times if you resubmit these emails they will validate on a second pass.

leading_period_removed- (valid) If a valid gmail.com email address starts with a period '.' we will remove it, so the email address is compatible with all mailing systems.

mail_server_did_not_respond- (unknown) These emails belong to a mail server that is not responding to mail commands. Most of the time, these emails will end up being invalid.

mail_server_temporary_error- (unknown) These emails belong to a mail server that is returning a temporary error. Most of the time, these emails will end up being invalid.

mailbox_quota_exceeded- (invalid) These emails exceeded their space quota and are not accepting emails. These emails are marked invalid.

mailbox_not_found- (invalid) These emails addresses are valid in syntax, but do not exist. These emails are marked invalid.

no_dns_entries- (invalid) These emails are valid in syntax, but the domain doesn't have any records in DNS or have incomplete DNS Records. Therefore, mail programs will be unable to or have difficulty sending to them. These emails are marked invalid.

possible_trap- (do_not_mail) These emails contain keywords that might correlate to possible spam traps like spam@ or @spamtrap.com. Examine these before deciding to send emails to them or not.

possible_typo- (invalid) These are emails of commonly misspelled popular domains. These emails are marked invalid.

role_based- (do_not_mail) These emails belong to a position or a group of people, like sales@ info@ and contact@. Role-based emails have a strong correlation to people reporting mails sent to them as spam and abuse.

role_based_catch_all- (do_not_mail) These emails are role-based and also belong to a catch_all domain.

timeout_exceeded- (unknown) These emails belong to a mail server that is responding extremely slow. Most of the time, these emails will end up being invalid.

unroutable_ip_address- (invalid) These emails domains point to an un-routable IP address, these are marked invalid.

disposable- (do_not_mail) These are temporary emails created for the sole purpose to sign up to websites without giving their real email address. These emails are short lived from 15 minutes to around 6 months. There is only 2 values (True and False). If you have valid emails with this flag set to TRUE, you shouldn't email them.

toxic- (do_not_mail) These email addresses are known to be abuse, spam, or bot created emails. If you have valid emails with this flag set to TRUE, you shouldn't email them.

alternate- (valid) These emails are valid, but they are likely to be secondary addresses for the users. Alternate emails are often used to sign up for accounts but otherwise do not see much engagement. As opposed to primary email addresses, which would look more formal, alternate emails will usually contain numbers or more special characters, e.g [email protected]. Identifying alternate email addresses allows for better email list segmentation. Users with formal emails are more likely to engage with your content.

We also provide other additional fields that you should take into consideration before emailing. If any of your valid emails have the disposable or toxic flag set to true, we recommend that you don't email them.

OTHER FIELDS

free_email- [true/false] If the email comes from a free provider.

mx_found- [true/false] Does the domain have an MX record.

mx_record- The preferred MX record of the domain.

smtp_provider- The SMTP Provider of the email or [null] (BETA).

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!