Email Verification API

8 min

Introduction

An email id is often given to a person to verify his employment. This API will verify a given email address & show information corresponding to the email address like organization, domain, full name, etc.

How to call the API

You are required to pass the access token received from the login call, an authorization header in the Email ID search request along with Email Id.

API Input Guidelines

Need to pass an email id & access token for sending API requests.

CURL Request

Preproduction

Production

curl --location --request POST 'https://preproduction.signzy.tech/api/v2/patrons/..patronId../emailverifications' \

--header 'Authorization: <token>' \
--header 'content-type: application/json' \
--data-raw '{
    "essentials": {
        "emailId": "<email Id>"
    }
}'

curl --location --request POST 'https://signzy.tech/api/v2/patrons/..patronId../emailverifications' \

--header 'Authorization: <token>' \
--header 'content-type: application/json' \
--data-raw '{
    "essentials": {
        "emailId": "<email Id>"
    }
}'

Input Parameters

Parameter Name	Required/Optional	Description
Authorization	Required	Contains the id parameter returned from the login step
content-type	Required	application/json
essentials.emailId	Required	Email id of the person

API Response

{
    "essentials": {
        "emailId": "Email ID"
    },
    "id": "",
    "patronId": "",
    "result": {
        "emailVerification": {
            "validEmail": "true",
            "emailValidationDetails": {
                "status": "valid",
                "result": "deliverable",
                "_deprecation_notice": "Using result is deprecated, use status instead",
                "score": 90,
                "email": "Email ID",
                "regexp": true,
                "gibberish": false,
                "disposable": false,
                "webmail": false,
                "mx_records": true,
                "smtp_server": true,
                "smtp_check": true,
                "accept_all": false,
                "block": false
            }
        },
        "personalInfo": {
            "person": {
                "name": {
                    "fullName": "Name",
                    "givenName": "firstName",
                    "familyName": "last name"
                },
                "email": "Email ID",
                "gender": "",
                "location": "",
                "timeZone": "",
                "utcOffset": "",
                "geo": {
                    "city": "NEW YORK",
                    "state": "NEW YORK",
                    "stateCode": "",
                    "country": "UNITED STATES",
                    "countryCode": "",
                    "lat": "",
                    "lng": ""
                },
                "bio": "",
                "site": "",
                "avatar": "",
                "employment": {
                    "domain": "",
                    "name": null,
                    "title": null,
                    "role": "",
                    "seniority": "",
                    "current": true,
                    "degree": null,
                    "description": null,
                    "emails": null,
                    "endDate": null,
                    "startDate": null
                },
                "facebook": {
                    "handle": ""
                },
                "github": {
                    "handle": "",
                    "id": "",
                    "avatar": "",
                    "company ": "",
                    "blog": "",
                    "followers": "",
                    "following": ""
                },
                "twitter": {
                    "handle": "",
                    "id": "",
                    "bio": "",
                    "followers": "",
                    "following": "",
                    "statuses": "",
                    "favorites": "",
                    "location": "",
                    "site": "",
                    "avatar": ""
                },
                "linkedin": {
                    "handle": ""
                },
                "googleplus": {
                    "handle": ""
                },
                "aboutme": {
                    "handle": "",
                    "bio": "",
                    "avatar": ""
                },
                "gravatar": {
                    "handle": "",
                    "urls": "",
                    "avatar": "",
                    "avatars": []
                },
                "fuzzy": "",
                "emailProvider": "",
                "indexedAt": ""
            },
            "company": {
                "name": "",
                "legalName": "",
                "domain": "",
                "domainAliases": [],
                "site": {
                    "phoneNumbers": [],
                    "emailAddresses": []
                },
                "category": {
                    "sector": "",
                    "industryGroup": "",
                    "industry": "",
                    "subIndustry": "",
                    "sicCode": "",
                    "naicsCode": ""
                },
                "tags": [
                    "B2B",
                    "ENTERPRISE SOFTWARE",
                    "SOFTWARE",
                    "INFORMATION TECHNOLOGY",
                    "SAAS",
                    "DIGITAL CONTRACTS",
                    "BIOMETRIC IDENTIFICATION",
                    "ID VERIFICATION",
                    "DIGITAL BACKGROUND VERIFICATION",
                    "BANK GRADE DIGITAL ONBOARDING",
                    "KYC",
                    "AML",
                    "CFT",
                    "DIGITAL IDENTITY",
                    "ARTIFICIAL INTELLIGENCE BIOMETRICS",
                    "COMPUTER VISION",
                    "CUSTOMER ONBOARDING",
                    "NO CODE AI",
                    "BANKING TECHNOLOGY",
                    "VIDEO KYC"
                ],
                "description": "",
                "foundedYear": "",
                "location": "",
                "timeZone": "",
                "utcOffset": "",
                "geo": {
                    "streetNumber": "",
                    "streetName": "",
                    "subPremise": "",
                    "city": "NEW YORK",
                    "postalCode": "",
                    "state": "NEW YORK",
                    "stateCode": "",
                    "country": "UNITED STATES",
                    "countryCode": "",
                    "lat": "",
                    "lng": ""
                },
                "logo": "https://persist.signzy.tech/api/files/417440579/download/086e531e35114dadb4411d77883579137aebd9b1e449438c90044e9a99f5a66d.jpg",
                "facebook": {
                    "handle": "https://www.facebook.com/TeamSignzy/",
                    "likes": ""
                },
                "linkedin": {
                    "handle": "http://www.linkedin.com/company/teamsignzy"
                },
                "twitter": {
                    "handle": "https://twitter.com/TeamSignzy",
                    "id": "",
                    "bio": "",
                    "followers": "",
                    "following": "",
                    "location": "",
                    "site": "",
                    "avatar": ""
                },
                "crunchbase": {
                    "handle": ""
                },
                "emailProvider": "",
                "type": "",
                "ticker": "",
                "identifiers": {
                    "usEIN": ""
                },
                "phone": "",
                "metrics": {
                    "alexaUsRank": "",
                    "alexaGlobalRank": "",
                    "employees": "190",
                    "employeesRange": "",
                    "marketCap": "",
                    "raised": "",
                    "annualRevenue": "",
                    "estimatedAnnualRevenue": "",
                    "fiscalYearEnd": ""
                },
                "indexedAt": "",
                "tech": [
                    "AMAZON AWS",
                    "ATLASSIAN CLOUD",
                    "BOOTSTRAP FRAMEWORK",
                    "GMAIL",
                    "GOOGLE APPS",
                    "GOOGLE FONT API",
                    "GOOGLE TAG MANAGER",
                    "GRAVITY FORMS",
                    "HUBSPOT",
                    "MICROSOFT OFFICE 365",
                    "MOBILE FRIENDLY",
                    "NGINX",
                    "REACT",
                    "VERCEL",
                    "WORDPRESS.ORG",
                    "RECAPTCHA"
                ],
                "parent": {
                    "domain": ""
                },
                "ultimate_parent": {
                    "domain": ""
                }
            }
        },
        "domainDetails": {
            "domain": "",
            "status": "",
            "updatedAt": "",
            "createdAt": "",
            "available": "",
            "registered": true,
            "domainId": "",
            "createdOn": "",
            "updatedOn": "",
            "expiresOn": "",
            "registrar": {
                "id": "",
                "name": "",
                "organization": "",
                "url": ""
            },
            "adminContacts": [
                {
                    "id": "",
                    "type": ,
                    "name": "",
                    "organization": "",
                    "address": "",
                    "city": "",
                    "zip": "",
                    "state": "",
                    "country": ,
                    "countryCode": "",
                    "phone": "",
                    "fax": "",
                    "email": "",
                    "url": null,
                    "createdOn": "",
                    "updatedOn": ""
                }
            ],
            "technicalContacts": [
                {
                    "id": "y",
                    "type": 3,
                    "name": "",
                    "organization": "",
                    "address": "",
                    "city": "",
                    "zip": "",
                    "state": "",
                    "country": null,
                    "countryCode": "",
                    "phone": "",
                    "fax": "",
                    "email": "",
                    "url": null,
                    "createdOn": "",
                    "updatedOn": ""
                }
            ],
            "nameservers": [
                {
                    "name": "",
                    "ipv4": null,
                    "ipv6": null
                },
                {
                    "name": "",
                    "ipv4": null,
                    "ipv6": null
                }
            ],
            "registrantContacts": [
                {
                    "id": "",
                    "type": ,
                    "name": "",
                    "organization": "",
                    "address": "",
                    "city": "",
                    "zip": "",
                    "state": "",
                    "country": null,
                    "countryCode": "",
                    "phone": "",
                    "fax": "",
                    "email": "",
                    "url": null,
                    "createdOn": "",
                    "updatedOn": ""
                }
            ]
        },
        "domainResult": {
            "ip": "",
            "continent_code": "",
            "continent": {
                "de": "",
                "en": "",
                "es": "",
                "fr": "",
                "ja": "",
                "pt-BR": "",
                "ru": "",
                "zh-CN": ""
            },
            "country_code": "",
            "country": {
                "de": "",
                "en": "",
                "es": "",
                "fr": "",
                "ja": "",
                "pt-BR": "",
                "ru": "",
                "zh-CN": ""
            },
            "latitude": ,
            "longitude": ,
            "timezone": ""
        },
        "emailId": "",
        "domain": ""
    }
}

Response Parameters

emailVerification Block

Parameters Name	Description
essentials	Essential part of the request
essentials.emailId	Contains email ID of the person
id	Unique user Id
patronid	Unique Patron Id
validEmail	whether the EmailID is valid or not(returns string value i,e, "true/false")
emailValidationDetails	Gives the details of validation for email address
emailValidationDetails.status	Gives the status of validation for email address
emailValidationDetails.result	whether the Email address is deliverable or not
emailValidationDetails.score	It is the deliverability score we give to the email address
emailValidationDetails.email	It is the entered email address or email address to look up
emailValidationDetails.regexp	It is true if our email address passes our regular expression(returns string value i.e "true/false")
emailValidationDetails.gibberish	It is true if we find this is an automatically generated email address(for example [email protected]")(returns string value i.e "true/false")
emailValidationDetails.disposable	It is true if we find this is an email address from a disposable email service (returns string value i.e. "true/false")
emailValidation_webmail	It is true if we find this is a email from webmail (for example Gmail) (returns string value i.e. "true/false)
emailValidationDetails. mx_records	It is true if we find MX records exists on the domain of the given email address (returns string valu i.e. "true/false")
emailValidationDetails.smtp_server	It is true if we connect to SMTP server successfully (returns string value i.e. "true/false")
emailValidationDetails. smtp_check	It is true if email address dosent bounce (returns string valu i.e. "true/false")
emailValidationDetails.accept_all	It is true if the server accept all the email address. It mean you can have false positives on SMTP checks (returns string valu i.e. "true/false")

PersonalInfo Block

Parameters Name	Description
person.name	It contains name of the person
name.fullName	Full formatted name of person. Sometimes this will be present even if the givenName or familyName aren’t available
name.givenName	First name of person (if found)
name.familyName	Last name of person (if found).
person.email	Last name of person (if found).
person.gender	Shows gender of the person (returns string value i.e."male or female").
person.location	The most accurate location we have
person.timeZone	The timezone for the person’s location
person.utcOffset	The offset from UTC in hours in the person’s location.
person.geo	It consists of Normalized geological details.
geo.city	Normalized city based on location
geo.state	Normalized state based on location
geo.stateCode	Two character state code based on location.
geo.countryCode	Normalized two letter country code based on location
geo.lat	General latitude based on location.
geo.lng	General longitude based on location.
person.bio	The most accurate bio we have
person.site	The person’s website
person.avatar	The best avatar url we have
person.employment	Company name
employment.domain	Company domain
employment.name	Company name
employment.title	Title at Company
employment.role	Role at Company
employment.seniority	Seniority at Company
person.facebook.handle	Facebook ID or screen name
person.github	GitHub account details of person
github.handle	GitHub handle
github.id	GitHub ID
github.avatar	GitHub avatar
github.company	GitHub company
github.blogs	GitHub bloh url
github.followers	Count of GitHub followers
github.following	Count of GitHub following
person.twitter	Twitter handle of the person
twitter.handle	Twitter screen name
twitter.id	Twitter ID
twitter.bio	Short about me summary publicly displayed beneath your Twitter profile picture
twitter.followers	Count of twitter followers
twitter.following	Count of twitter following
twitter.statuses	Tweet count
twitter.favorites	Indicators that a tweet is well-liked or popular among online users.
twitter.location	It is the precise location of the person as per twitter
twitter.site	Twitter site
twitter.avatar	HTTP Twitter avatar
person.linked.in.handle	LinkedIn url (i.e. /pub/alex-maccaw/78/929/ab5)
person.googleplus.handle	Google plus handle
person.aboutme	About.me handle
aboutme.handle	About.me handle
aboutme.bio	Short information of person in about me
aboutme.avatar	Aboutme avatar URL
gravatar.handle	Gravatar handle
gravatar.urls	Array of URLs from Gravatar
gravatar.avatar	Gravatar main avarar url
gravatar.avatars	Array of objects a avarae url, and a type (i.e. thumbnail)
person.fuzzy	Indicating whether or not the lookup is a fuzzy or exact search
person.emailProvider	is the email domain associated with a free email provider (i.e. Gmail)?
person.indexAt	The time at which we indexed this data
personalInfo.company.name	Name of company
company.legalname	Legal name of company
company.domain	Domain of company's website
company.domainAliases	List of domains also used by the company
company.site	It contains phone number and emailAddress of company
site.phoneNumbers	List of phone numbers mentioned on the company's website
site.emailAddress	List of email addresses mentioned on the company's website
company.category	It contains category information of the company
category.sector	Board sector (see a complete list)
category.industryGroup	Industry group (see a complete list)
category.industry	Industry (see a complete list)
category.subIndustry	subIndustry (see a complete list)
category.sisCode	Two digit category SIC code
category.naicsCode	Two digit category NAICS code
company.tags	List of market categories (see a complete list)
company.description	Description of the company
company.foundedYear	Year company was founded
company.location	Address of company
company.timeZone	The timezone of company's location
company.utcOffset	The offset from the UTC in hours in the company's location
company.geo.streetNumber	Headquarters street number
company.geo.streetName	Headquaters street name
company.geo.subPremise	Headquaters suitr number
company.geo.city	Headquaters city name
company.geo.postalCode	Headquaters postal/zip code
company.geo.country	Headquaters country name
company.geo.countryCode	Headquaters country code
company.geo.lat	Headquaters latitude
company.geo.lan	Headquaters longitude
company.logo	SRC of company logo
company.facebook.handle	Company's face book handle
company.facebook.likes	Count of likes on Facebook
company.linkedin.handle	Company's linked.in handle, Twitter screen name
company.twitter.handle	Company's twitter handle
company.twitter.id	Twitter ID
company.twitter.bio	Short information about company on twitter in company's page
company.twitter.followers	Count of twitter followers
company.twitter.following	Count of twitter followings
company.twitter.location	Location of company mentioned on twitter
company.twitter.site	Twitter site
company.twitter.avatar	HTTP twitter avatar
company.crunchbase.handle	Crunchbase handle
company.emailProvider	It is the domain associated with a free email provider (i.e. Gmail)?
company.type	The company’s type, either education, government, nonprofit, private, public, or personal.
company.ticker	Stock ticker symbol
company.identifiers.usEIN	US Employer Identification Number
company.phone	International headquarters phone number
company.metrics	metrics of company
metrics.alexaUsRank	Alexa's US site rank
metrics.alexaGlobalRank	Alexas Global site rank
metrics.employees	Amount of employees
metrics.employeesRange	Employees range (see a complete list)
metrics.marketCap	Market Cap
metrics.raised	Total amount raised
metrics.annualRevenue	Annual Revenue (public companies only)
metrics.estimatedAnnualRevenue	Estimated annual revenue range (see a complete list)
metrics.fiscalYearEnd	Month that the fiscal year ends (1-indexed)
company.indexAt	The time at which we indexed this data
company.tech	Array of technology tags
company.parent.domain	The domain of the parent company (if any)
company.ultimate_parent.domain	The domain of the ultimate_parent company (if any)

domainDetails block

Parameters Name	Description
domainDetails.domain	Domain of company site
domainDetails.status	Status of the domain
domainDetails.updatedAt	last updation of domain
domainDetails.createdAt	creation date of the domain
domainDetails.available	It describes availability of domain
domainDetails.registered	It holds the value true/ false
domainDetails.domainId	Id of the domain
domainDetails.createdOn	Created date of the domain
domainDetails.updatedOn	Date of latest update done on Domain
domainDetails.expiresOn	Date of expiry of the domain

domainResult

Parameters Name	Description
domainResult.ip	IP address
domainResult.continent_code	Code correesponding to continent
domainResult.country_code	Code associated with the country
domainResult.latitude	latitude information
domainResult.longitude	longitude information
domainResult.timezone	Timezone Information
result.emaild	Email id of the person
resultdomain	domain infor mation of the email

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].