Email Domain Detailed API

Overview

A unified API that combines email verification and domain insights to validate leads, check email authenticity, and provide domain details (ownership, creation/expiry dates) in one call, simplifying lead qualification and improving data accuracy.

This API has one endpoint:

signzy.app/api/v3/email/emailDetailed: The API takes one input, that is email.

API Description

API cURL

curl --location 'https://api-preproduction.signzy.app/api/v3/email/emailDetailed' \
--header 'Content-Type: application/json' \
--header 'Authorization:' \
--data-raw '{
    "email": "",
    "declaredCompany": "",
    "declaredName": ""    
}'

Input Table

Parameters	Required	Type
email	Yes	String
declaredCompany	No	String
declaredName	No	String

API Output

{
    "result": {
        "emailVerifyData": {
            "email": "",
            "status": "",
            "subStatus": "",
            "freeEmail": "",
            "didYouMean": "",
            "account": "",
            "domain": "",
            "domainAgeDays": "",
            "smtpProvider": "",
            "mxFound": "",
            "mxRecord": "",
            "gender": "",
            "country": "",
            "region": "",
            "city": "",
            "zipcode": "",
            "firstName": "",
            "lastName": "",
            "name": ""
        },
        "domain": {
            "domainName": "",
            "updatedDate": "",
            "expirationDate": "",
            "creationDate": "",
            "registrantContactDetails": {
                "registrantOrganization": "",
                "registrantStreet": "",
                "registrantCity": "",
                "registrantStateProvince": "",
                "registrantPostalCode": "",
                "registrantCountry": ""
            },
            "registrantPhone": "",
            "registrantEmail": "",
            "organizationName": "",
            "nameServers": []
        },
        "detailed": {
            "person": {
                "firstName": "",
                "lastName": "",
                "name": "",
                "linkedinUrl": "",
                "title": "",
                "emailStatus": "",
                "twitterUrl": "",
                "githubUrl": "",
                "facebookUrl": "",
                "extrapolatedEmailConfidence": "",
                "headline": "",
                "email": "",
                "employmentHistory": [
                    {
                        "current": null,
                        "degree": "",
                        "description": "",
                        "emails": "",
                        "endDate": "",
                        "gradeLevel": "",
                        "kind": "",
                        "major": "",
                        "organizationName": "",
                        "rawAddress": "",
                        "startDate": "",
                        "title": ""
                    }
                ],
                "state": "",
                "city": "",
                "country": "",
                "organization": {
                    "name": "",
                    "websiteUrl": "",
                    "linkedinUrl": "",
                    "twitterUrl": "",
                    "primaryPhone": {
                        "sanitizedNumber": ""
                    },
                    "phone": "",
                    "foundedYear": null,
                    "primaryDomain": "",
                    "sanitizedPhone": "",
                    "industry": "",
                    "keywords": [],
                    "estimatedNumEmployees": null,
                    "industries": [],
                    "secondaryIndustries": [],
                    "retailLocationCount": null,
                    "rawAddress": "",
                    "streetAddress": "",
                    "city": "",
                    "state": "",
                    "postalCode": "",
                    "country": "",
                    "seoDescription": "",
                    "shortDescription": "",
                    "suborganizations": [],
                    "numSuborganizations": null,
                    "annualRevenuePrinted": "",
                    "annualRevenue": null,
                    "totalFunding": null,
                    "totalFundingPrinted": "",
                    "latestFundingRoundDate": "",
                    "latestFundingStage": "",
                    "fundingEvents": [],
                    "technologyNames": [],
                    "currentTechnologies": [],
                    "orgChartSector": "",
                    "orgChartRemoved": "",
                    "orgChartShowDepartmentFilter": ""
                },
                "intentStrength": "",
                "showIntent": false,
                "emailDomainCatchall": false,
                "revealedForCurrentTeam": false,
                "departments": [],
                "subdepartments": [],
                "functions": [],
                "seniority": ""
            }
        }
    }
}

Output Table

Key	Type	Description
emailverifyData	Object	Contains data related to email verification.
emailverifyData.email	String	The email address being verified.
emailverifyData.status	String	The overall status of the email verification (e.g., "valid", "invalid").
emailverifyData.sub_status	String	A more detailed sub-status of the email verification.
emailverifyData.free_email	String	Indicates if the email address belongs to a free email provider (e.g., "true", "false").
emailverifyData.did_you_mean	String	A suggested correction for the email address, if any.
emailverifyData.account	String	The username or account part of the email address.
emailverifyData.domain	String	The domain part of the email address.
emailverifyData.domain_age_days	Integer	The age of the email domain in days.
emailverifyData.smtp_provider	String	The SMTP provider associated with the email domain.
emailverifyData.mx_found	String	Indicates if MX records were found for the email domain (e.g., "true", "false").
emailverifyData.mx_record	String	The MX record(s) found for the email domain.
Domain	Object	Contains information about the domain.
Domain.domainName	String	The name of the domain.
Domain.updatedDate	String	The date when the domain information was last updated.
Domain.expirationDate	String	The date when the domain registration is set to expire.
Domain.creationDate	String	The date when the domain was originally created.
Domain.registrantContactDetails	Object	Details of the domain registrant's contact information.
Domain.registrantContactDetails.registrantOrganization	String	The organization of the domain registrant.
Domain.registrantContactDetails.registrantStreet	String	The street address of the domain registrant.
Domain.registrantContactDetails.registrantCity	String	The city of the domain registrant.
Domain.registrantContactDetails.registrantStateProvince	String	The state or province of the domain registrant.
Domain.registrantContactDetails.registrantPostalCode	String	The postal code of the domain registrant.
Domain.registrantContactDetails.registrantCountry	String	The country of the domain registrant.
Domain.registrantPhone	String	The phone number of the domain registrant.
Domain.registrantemail	String	The email address of the domain registrant.
Domain.organizationName	String	The name of the organization associated with the domain registration.
Domain.nameServers	Array	An array of strings representing the name servers for the domain.
detailed	Object	Contains detailed information.
detailed.person	Object	Contains detailed information about a person.
detailed.person.first_name	String	The first name of the person.
detailed.person.last_name	String	The last name of the person.
detailed.person.name	String	The full name of the person.
detailed.person.linkedin_url	String	The LinkedIn profile URL of the person.
detailed.person.title	String	The job title of the person.
detailed.person.email_status	String	The status of the person's email (likely null if not available).
detailed.person.twitter_url	String	The Twitter profile URL of the person (likely null if not available).
detailed.person.github_url	String	The GitHub profile URL of the person (likely null if not available).
detailed.person.facebook_url	String	The Facebook profile URL of the person (likely null if not available).
detailed.person.extrapolated_email_confidence	String	The confidence level of an extrapolated email address (likely null if not available).
detailed.person.headline	String	The headline or summary of the person's professional profile.
detailed.person.email	String	The email address of the person.
detailed.person.employment_history	Array	An array of objects representing the person's employment history.
detailed.person.employment_history[].created_at	String	The creation timestamp of the employment record (likely null if not available).
detailed.person.employment_history[].current	String	Indicates if the employment is the person's current role (likely null if not available).
detailed.person.employment_history[].degree	String	The degree obtained in this employment (likely null if not applicable or not available).
detailed.person.employment_history[].description	String	A description of the role or responsibilities (likely null if not available).
detailed.person.employment_history[].emails	String	Emails associated with this employment (likely null if not available).
detailed.person.employment_history[].end_date	String	The end date of the employment (likely null if current or not available).
detailed.person.employment_history[].grade_level	String	The grade level in this employment (likely null if not applicable or not available).
detailed.person.employment_history[].kind	String	The kind of employment (likely null if not available).
detailed.person.employment_history[].major	String	The major field of study in this employment (likely null if not applicable or not available).
detailed.person.employment_history[].organization_name	String	The name of the organization in this employment.
detailed.person.employment_history[].raw_address	String	The raw address of the organization in this employment (likely null if not available).
detailed.person.employment_history[].start_date	String	The start date of the employment.
detailed.person.employment_history[].title	String	The job title in this employment.
detailed.person.state	String	The state of the person's location (likely null if not available).
detailed.person.city	String	The city of the person's location.
detailed.person.country	String	The country of the person's location.
detailed.person.organization	Object	Information about the person's current organization.
detailed.person.organization.name	String	The name of the organization.
detailed.person.organization.website_url	String	The website URL of the organization.
detailed.person.organization.linkedin_url	String	The LinkedIn URL of the organization.
detailed.person.organization.twitter_url	String	The Twitter URL of the organization.
detailed.person.organization.primary_phone	Object	The primary phone number of the organization.
detailed.person.organization.primary_phone.number	String	The primary phone number of the organization.
detailed.person.organization.primary_phone.source	String	The source of the primary phone number information.
detailed.person.organization.primary_phone.sanitized_number	String	The sanitized version of the primary phone number.
detailed.person.organization.phone	String	The phone number of the organization.
detailed.person.organization.linkedin_uid	String	The LinkedIn user ID of the organization.
detailed.person.organization.founded_year	Integer	The year the organization was founded.
detailed.person.organization.primary_domain	String	The primary domain of the organization.
detailed.person.organization.sanitized_phone	String	The sanitized phone number of the organization.
detailed.person.organization.industry	String	The industry of the organization.
detailed.person.organization.keywords	Array	An array of keywords associated with the organization.
detailed.person.organization.estimated_num_employees	Integer	The estimated number of employees in the organization.
detailed.person.organization.industries	Array	An array of industries the organization operates in.
detailed.person.organization.secondary_industries	Array	An array of secondary industries the organization operates in.
detailed.person.organization.snippets_loaded	String	Indicates if snippets related to the organization have been loaded (likely null if not available).
detailed.person.organization.retail_location_count	Integer	The number of retail locations of the organization.
detailed.person.organization.raw_address	String	The raw address of the organization.
detailed.person.organization.street_address	String	The street address of the organization.
detailed.person.organization.city	String	The city of the organization.
detailed.person.organization.state	String	The state of the organization.
detailed.person.organization.postal_code	String	The postal code of the organization.
detailed.person.organization.country	String	The country of the organization.
detailed.person.organization.seo_description	String	The SEO description of the organization.
detailed.person.organization.short_description	String	A short description of the organization.
detailed.person.organization.suborganizations	Array	An array of sub-organizations.
detailed.person.organization.num_suborganizations	Integer	The number of sub-organizations.
detailed.person.organization.annual_revenue_printed	String	The annual revenue of the organization (in printed format).
detailed.person.organization.annual_revenue	Integer	The annual revenue of the organization.
detailed.person.organization.total_funding	Integer	The total funding raised by the organization.
detailed.person.organization.total_funding_printed	String	The total funding raised by the organization (in printed format).
detailed.person.organization.latest_funding_round_date	String	The date of the organization's latest funding round.
detailed.person.organization.latest_funding_stage	String	The stage of the organization's latest funding round.
detailed.person.organization.funding_events	Array	An array of funding events for the organization.
detailed.person.organization.funding_events[].date	String	The date of the funding event.
detailed.person.organization.funding_events[].news_url	String	The URL of news related to the funding event (likely null if not available).
detailed.person.organization.funding_events[].type	String	The type of funding event (e.g., "Seed", "Series A").
detailed.person.organization.funding_events[].investors	String	The investors in the funding event.
detailed.person.organization.funding_events[].amount	String	The amount of funding raised in the event.
detailed.person.organization.funding_events[].currency	String	The currency of the funding amount.
detailed.person.organization.technology_names	Array	An array of technology names used by the organization.
detailed.person.organization.current_technologies	Array	An array of objects representing the current technologies used by the organization.
detailed.person.organization.current_technologies[].uid	String	A unique identifier for the technology.
detailed.person.organization.current_technologies[].name	String	The name of the technology.
detailed.person.organization.current_technologies[].category	String	The category of technology.
detailed.person.organization.org_chart_root_people_ids	Array	An array of IDs of root people in the organization's chart.
detailed.person.organization.org_chart_sector	String	The sector of the organization's chart (likely null if not available).
detailed.person.organization.org_chart_removed	String	Indicates if the organization's chart has been removed (likely null if not available).
detailed.person.organization.org_chart_show_department_filter	String	Indicates if the department filter is shown in the organization's chart (likely null if not available).
detailed.person.intent_strength	String	The strength of the person's intent (likely null if not available).
detailed.person.show_intent	String	Indicates if intent information is shown for the person (likely null if not available).
detailed.person.email_domain_catchall	String	Indicates if the person's email domain has a catch-all policy (likely null if not available).
detailed.person.revealed_for_current_team	String	Indicates if the person's information has been revealed for the current team (likely null if not available).
detailed.person.departments	Array	An array of departments the person belongs to.
detailed.person.subdepartments	Array	An array of sub-departments the person belongs to.
detailed.person.functions	Array	An array of functions the person is involved in.
detailed.person.seniority	String	The seniority level of the person.

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.

Status Codes

Code	status	Description
200	Success	The request id was successfully generated.
409	Upstream Error	Usptream down, please try again
400	Bad request	Error in input parameters
500	Internal Server Error	Internal Server Error Please contact support

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us 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!