--- title: Email Verification API slug: us-apis/email-verification-api description: Learn how to verify email addresses and access associated information using our API. Get details on email validity, status, domain age, SMTP provider, MX record, and more. This document provides code examples and a comprehensive description of response pa docTags: createdAt: 2022-09-14T10:30:10.000Z --- ## Introduction An email id is often given to a person to verify his employment. This API will verify a given email address & show information from 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 the full email id & access token for sending API requests. :::ApiMethodV2 ```json { "tab": "examples", "url": "https://preproduction.signzy.tech/api/v2/patrons/6140962af6d4030eae0496e0/emailverificationsv2", "name": "Email Verification", "method": "GET", "request": { "pathParameters": [], "queryParameters": [], "headerParameters": [ { "kind": "required", "name": "Authorization", "type": "string", "children": [], "description": "Access Token" }, { "kind": "required", "name": "Content-Type", "type": "string", "children": [], "description": "Application/JSON, Text/Plain" }, { "kind": "required", "name": "essentials", "type": "Object", "children": [ { "kind": "required", "name": "essentials.emailId", "type": "string", "description": "Individual email Id" } ], "description": "Contains request data as JSON object" } ], "bodyDataParameters": [], "formDataParameters": [] }, "results": { "languages": [ { "id": "k2vgqAnpMIgeFR30dWtmQ", "code": "{\n \"essentials\": {\n \"emailId\": \"\"\n },\n \"id\": \"\",\n \"patronId\": \"\",\n \"result\": {\n \"emailId\": \"\",\n \"validEmail\": \"true\",\n \"status\": \"deliverable\",\n \"subStatus\": \"\",\n \"freeEmail\": \"false\",\n \"didYouMean\": \"\",\n \"account\": \"ankit\",\n \"domain\": \"signzy.com\",\n \"domainAgeDays\": \"2637\",\n \"smtpProvider\": \"g-suite\",\n \"mxFound\": \"true\",\n \"mxRecord\": \"aspmx.l.google.com\",\n \"personalDetails\": {\n \"name\": \"ANKIT RATAN\",\n \"email\": \"\",\n \"location\": \"\",\n \"timeZone\": \"\",\n \"bio\": \"BUILDING SIGNZY, BANKING CUSTOMER ACQUISITION 3.0, KYC\\nFORBES 30UNDER30\",\n \"avatar\": \"https://persist.signzy.tech/api/files/417458825/download/c8e30dbcea0741c0a2c873745738be02683c91886bb34fd2964d45990b63438f.jpg\",\n \"employment\": \"\",\n \"socialMediaHandles\": {\n \"facebook\": \"\",\n \"github\": \"\",\n \"twitter\": \"\",\n \"linkedin\": \"http://www.linkedin.com/in/ankitratan\",\n \"googleplus\": \"\",\n \"aboutme\": \"\",\n \"gravatar\": \"\"\n }\n },\n \"companyDetails\": {\n \"name\": \"SIGNZY\",\n \"legalName\": \"\",\n \"domain\": \"signzy.com\",\n \"domainAliases\": [],\n \"phoneNumbers\": [],\n \"emailAddresses\": [],\n \"category\": {\n \"sector\": \"\",\n \"industryGroup\": \"\",\n \"industry\": \"FINANCIAL SERVICES\",\n \"subIndustry\": \"\",\n \"sicCode\": \"\",\n \"naicsCode\": \"\"\n },\n \"tags\": [\n \"B2B\",\n \"ENTERPRISE SOFTWARE\",\n \"SOFTWARE\",\n \"INFORMATION TECHNOLOGY\",\n \"SAAS\",\n \"DIGITAL CONTRACTS\",\n \"BIOMETRIC IDENTIFICATION\",\n \"ID VERIFICATION\",\n \"DIGITAL BACKGROUND VERIFICATION\",\n \"BANK GRADE DIGITAL ONBOARDING\",\n \"KYC\",\n \"AML\",\n \"CFT\",\n \"DIGITAL IDENTITY\",\n \"ARTIFICIAL INTELLIGENCE BIOMETRICS\",\n \"COMPUTER VISION\",\n \"CUSTOMER ONBOARDING\",\n \"NO CODE AI\",\n \"BANKING TECHNOLOGY\",\n \"VIDEO KYC\"\n ],\n \"description\": \"SIGNZY IS A MARKET-LEADING PLATFORM THAT IS REDEFINING THE SPEED, ACCURACY, AND EXPERIENCE OF HOW FINANCIAL INSTITUTIONS ARE ONBOARDING CUSTOMERS AND BUSINESSES - USING THE DIGITAL MEDIUM. THE COMPANY'S AWARD-WINNING NO-CODE GO PLATFORM DELIVERS SEAMLESS, END-TO-END, AND MULTI-CHANNEL ONBOARDING JOURNEYS WHILE OFFERING TOTALLY CUSTOMIZABLE WORKFLOWS. IT GIVES THESE PLAYERS ACCESS TO AN AGGREGATED MARKETPLACE OF 240+ BESPOKE APIS THAT CAN BE EASILY ADDED TO ANY WORKFLOW WITH SIMPLE WIDGETS.\\n\\nSIGNZY IS ENABLING 10 MILLION+ END CUSTOMER AND BUSINESS ONBOARDINGS EVERY MONTH AT A SUCCESS RATE OF 99% WHILE REDUCING THE SPEED TO MARKET FROM 6 MONTHS TO 3-4 WEEKS. IT WORKS WITH OVER 240+ FIS GLOBALLY INCLUDING THE 4 LARGEST BANKS IN INDIA, A TOP 3 ACQUIRING BANK IN THE US, AND HAS A STRONG GLOBAL PARTNERSHIP WITH MASTERCARD AND MICROSOFT. THE COMPANY'S PRODUCT TEAM IS BASED OUT OF BENGALURU AND IT HAS A STRONG PRESENCE IN MUMBAI, NEW YORK, AND DUBAI.\",\n \"foundedYear\": \"2015\",\n \"location\": \"NEW YORK, NEW YORK, UNITED STATES\",\n \"linkedinHandle\": \" \",\n \"usEIN\": \"\",\n \"metrics\": {\n \"alexaUsRank\": \"\",\n \"alexaGlobalRank\": \"\",\n \"employeesRange\": \"\",\n \"marketCap\": \"\",\n \"raised\": \"\",\n \"annualRevenue\": \"6000000\",\n \"estimatedAnnualRevenue\": \"6M\"\n }\n },\n \"domainDetails\": {\n \"ip\": \"13.234.218.151\",\n \"continentCode\": \"AS\",\n \"countryCode\": \"IN\",\n \"latitude\": 19.0748,\n \"longitude\": 72.8856,\n \"timezone\": \"Asia/Kolkata\",\n \"domain\": \"signzy.com\",\n \"status\": \"registered\",\n \"available\": \"\",\n \"registered\": true,\n \"domainId\": \"1943617045_DOMAIN_COM-VRSN\",\n \"createdOn\": \"1/7/2015\",\n \"updatedOn\": \"18/9/2022\",\n \"expiresOn\": \"1/7/2032\",\n \"registrar\": {\n \"id\": \"146\",\n \"name\": \"GoDaddy.com, LLC\",\n \"organization\": \"GoDaddy.com, LLC\",\n \"url\": \"https://www.godaddy.com\"\n },\n \"nameservers\": [\n {\n \"name\": \"ns77.domaincontrol.com\",\n \"ipv4\": \"\",\n \"ipv6\": \"\"\n },\n {\n \"name\": \"ns78.domaincontrol.com\",\n \"ipv4\": \"\",\n \"ipv6\": \"\"\n }\n ]\n }\n }\n}", "language": "200", "customLabel": "" } ], "selectedLanguageId": "k2vgqAnpMIgeFR30dWtmQ" }, "examples": { "languages": [ { "id": "LVV7u2XcQpGZohpLEzlu-", "code": "curl --location --request POST 'https://preproduction.signzy.tech/api/v2/patrons//emailverificationsv2' \\\n--header 'Accept: application/json, text/plain, */*' \\\n--header 'Authorization: ' \\\n--header 'Content-Type: application/json' \n--data-raw {\n \"essentials\": {\n \"emailId\": \"\"\n }\n}", "language": "curl", "customLabel": "Preproduction" }, { "id": "yeerVCFzIKWtgt-FU7UDS", "code": "curl --location --request POST 'https://signzy.tech/api/v2/patrons//emailverificationsv2' \\\r\n--header 'Accept: application/json, text/plain, */*' \\\r\n--header 'Authorization: ' \\\r\n--header 'Content-Type: application/json' \r\n--data-raw {\r\n \"essentials\": {\r\n \"emailId\": \"\"\r\n }\r\n}", "language": "curl", "customLabel": "Production" } ], "selectedLanguageId": "LVV7u2XcQpGZohpLEzlu-" }, "description": "Get a person's information from email Id.", "currentNewParameter": { "label": "Body Parameter", "value": "bodyDataParameters" }, "autoGeneratedAnchorSlug": "email-verification", "legacyHash": "WHC6doUoboYtT5SkeyhNG" } ``` ::: ### Response Parameters | **PARAMETERS** | **DESCRIPTION** | | -------------- | --------------------------------------------------------------------------------------------------------- | | emailId | Email Id to be verified | | validEmail | If the email is valid then 'true' otherwise 'false' | | status | Returns the main status of the verification. It can take 2 possible values: Deliverable and Undeliverable | | subStatus | Extra information about the email Id | | freeEmail | \[true/false] If the email comes from a free provider. | | didYouMean | Suggestive Fix for an email typo | | account | The portion of the email address before the "@" symbol. | | domain | The portion of the email address after the "@" symbol. | | domainAgeDays | Age of the email domain in days or null. | | smtpProvider | The SMTP Provider of the email or null | | mxFound | \[true/false] Corresponding to the domain have an MX record. | | mxRecord | The preferred MX record of the domain | ### personalDetails block | **PARAMETERS** | **DESCRIPTION** | | ------------------ | ------------------------------------------------------------------------- | | name | Full formatted name of person. | | name | Full name of the person. | | email | Accurate work email of the person. | | location | City, State and/or Country of person. | | timeZone | IANA time zone of person (ex: America/New\_York). | | bio | The most accurate person bio we surface from a variety of social sources. | | avatar | The best personal avatar we surface from a variety of social sources. | | employment | Company name of person's employer. | | socialMediaHandles | Social Media Handles handle of person. | ### companyDetails block | **PARAMETERS** | **DESCRIPTION** | | ------------------------------ | ---------------------------------------------------------------------------------------------- | | name | Name of company | | legalName | Legal name of company. | | domain | Domain of company’s website. | | domainAliases | List of domains that redirect to company's main domain. | | phoneNumbers | List of phone numbers that appear on company’s website. | | emailAddresses | List of email addresses that appear on the company’s website. | | category.sector | Broadest tier of company's industry classification. | | category.industryGroup | Second tier of company's industry classification. | | category.industry | Third tier of company's industry classification. | | category.subIndustry | Most specific tier of company's industry classification. | | category.sicCode | Two digit company SIC (Standard Industry Classification) codes. | | category.naicsCode | Two digit company NAICS (North American Industry Classification System) codes. | | tags | List of company vertical descriptors. Typically more granular than industry classification. | | description | Description of company. | | foundedYear | Year company was founded. | | location | Address of company headquarters. | | linkedinHandle | LinkedIn handle of company. | | usEIN | US Employer Identification Number of company. | | metrics.alexaUsRank | US rank of company site traffic as calculated by Alexa (1 being the most trafficked site). | | metrics.alexaGlobalRank | Global rank of company site traffic as calculated by Alexa (1 being the most trafficked site). | | metrics.employeesRange | Bucketed employee ranges for company (useful for segmentation). | | metrics.marketCap | Total market capitalization for company (public companies only). | | metrics.raised | Total amount of funding raised by company. | | metrics.annualRevenue | Annual revenue for company (public companies only). | | metrics.estimatedAnnualRevenue | Our proprietary estimated annual revenue range for company. | ### domainDetails block | **PARAMETERS** | **DESCRIPTION** | | ---------------------- | ----------------------------------------------- | | ip | Visitor IP address. | | continentCode | Two-letter continent code. | | countryCode | Two-letter ISO 3166-1 alpha-2 country code. | | latitude | Latitude/ | | longitude | Longitude. | | timezone | Timezone. | | domain | Domain Name | | status | Status of the Domain | | available | Availabilty of the domain | | registered | Registered or not, true or false | | domainId | Unique Id of the domain | | createdOn | Created on date of the domain | | updatedOn | Updated on date of the domain | | expiresOn | Expiry date of the domain | | registrar.id | Registrar Id | | registrar.name | Registrar Name | | registrar.organization | Registrar Organization | | registrar.url | Registrar URL | | nameservers | List of NameServers associated with the Domain. | | nameservers.name | Name of the NameServers. | | nameservers.ipv4 | IP of the NameServers in ipv4 format. | | nameservers.ipv6 | IP of the NameServers in ipv6 format. | :::hint{type="info"} ### 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 [help@signzy.com](#). 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! :::