{"success":true,"data":{"email":"[email protected]","valid":true,"syntax":true,"mx":true,"disposable":false,"role":false,"free_provider":true,"typo_suggestion":null,"email_type":"free","deliverability":"high","risk_score":5},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26035/validate+email&email=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"results":[{"email":"[email protected]","valid":true,"syntax":true,"mx":true,"disposable":false,"role":false,"free_provider":true,"typo_suggestion":null,"email_type":"free","deliverability":"high","risk_score":5},{"email":"[email protected]","valid":true,"syntax":true,"mx":true,"disposable":true,"role":false,"free_provider":false,"typo_suggestion":null,"email_type":"disposable","deliverability":"low","risk_score":75},{"email":"[email protected]","valid":true,"syntax":true,"mx":true,"disposable":false,"role":false,"free_provider":false,"typo_suggestion":null,"email_type":"business","deliverability":"high","risk_score":0}],"summary":{"total":3,"valid_count":3,"invalid_count":0,"high_risk_count":1,"disposable_count":1,"role_count":0,"free_provider_count":1}},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request POST 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26036/validate+emails+batch' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"emails": ["[email protected]", "[email protected]", "[email protected]"]}'
{"success":true,"data":{"email":"[email protected]","valid":true,"reason":null},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26037/check+syntax&email=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"email":"[email protected]","risk_score":5,"deliverability":"high","breakdown":{"syntax_failed":false,"no_mx":false,"mx_timeout":false,"disposable":false,"role_based":false,"free_provider":true,"typo_present":false}},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26038/get+risk+score&email=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"domain":"gmial.com","mx":false,"mx_records":[],"disposable":false,"free_provider":false,"provider_name":null,"typo_of":"gmail.com"},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26039/get+domain+intelligence&domain=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"results":[{"domain":"gmail.com","mx":true,"mx_records":[{"exchange":"gmail-smtp-in.l.google.com","priority":5},{"exchange":"alt1.gmail-smtp-in.l.google.com","priority":10},{"exchange":"alt2.gmail-smtp-in.l.google.com","priority":20},{"exchange":"alt3.gmail-smtp-in.l.google.com","priority":30},{"exchange":"alt4.gmail-smtp-in.l.google.com","priority":40}],"disposable":false,"free_provider":true,"provider_name":"Gmail","typo_of":null},{"domain":"mailinator.com","mx":true,"mx_records":[{"exchange":"mail.mailinator.com","priority":1},{"exchange":"mail2.mailinator.com","priority":1}],"disposable":true,"free_provider":false,"provider_name":null,"typo_of":null},{"domain":"acmewidgets.com","mx":true,"mx_records":[{"exchange":"spamtitan.isomedia.com","priority":5}],"disposable":false,"free_provider":false,"provider_name":null,"typo_of":null}],"summary":{"total":3,"mx_valid_count":3,"disposable_count":1,"free_provider_count":1,"typo_count":0}},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request POST 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26040/get+domain+intelligence+batch' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{"domains": ["gmail.com", "mailinator.com", "acmewidgets.com"]}'
{"success":true,"data":{"domain":"gmail.com","mx":true,"records":[{"exchange":"gmail-smtp-in.l.google.com","priority":5},{"exchange":"alt1.gmail-smtp-in.l.google.com","priority":10},{"exchange":"alt2.gmail-smtp-in.l.google.com","priority":20},{"exchange":"alt3.gmail-smtp-in.l.google.com","priority":30},{"exchange":"alt4.gmail-smtp-in.l.google.com","priority":40}],"lookup_time_ms":2.442,"timeout":false},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26041/check+mx+records&domain=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"domain":"mailinator.com","disposable":true,"domain_count":121570},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26042/check+disposable+domain&domain=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"domains":["0-180.com","0-30-24.com","0-420.com"],"page":1,"limit":3,"total":121570,"total_pages":40524},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26043/list+disposable+domains?page=1&limit=3' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"email":"[email protected]","role":true,"prefix":"support","category":"support"},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26044/check+role+address&email=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"original":"[email protected]","suggestion":"gmail.com","corrected_email":"[email protected]","confidence":"high"},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26045/suggest+typo+correction&email=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"domain":"gmail.com","free_provider":true,"provider_name":"Gmail"},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26046/check+free+provider&domain=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"Example Response":"No response example available for now."}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26047/list+free+providers' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"original":"[email protected]","normalized":"[email protected]","changed":true,"rules_applied":["lowercased","stripped_plus_tag","stripped_dots"]},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26048/normalize+email&email=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"email":"[email protected]","domain":"acmewidgets.com","email_type":"business","is_business":true},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26049/classify+email+type&email=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{"success":true,"data":{"uptime_seconds":624071,"version":"1.0.0","node_version":"v18.20.5","disposable_domain_count":121570,"free_provider_count":172,"isp_count":43,"role_prefix_count":78,"typo_map_size":208,"endpoints":19,"smtp_enabled":false},"meta":{"disclaimer":"Validation results are indicative only. Deliverability cannot be fully guaranteed without live SMTP verification.","cached":false}}
curl --location --request GET 'https://zylalabs.com/api/13005/comprehensive+email+verification+and+deliverability+api/26050/health+check' --header 'Authorization: Bearer YOUR_API_KEY'
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Comprehensive Email Verification and Deliverability API simply include your bearer token in the Authorization header.
| Header | Description |
|---|---|
Authorization
|
Required
Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.
|
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
(Save 2 months with annual billing 🎉)
Validates email addresses against RFC 5322 syntax, checks MX records via live DNS, detects disposable domains from a list of over 121,000 known providers, flags role-based addresses, suggests corrections for common domain typos, classifies the domain type, and normalizes addresses for de-duplication. Each request returns a weighted risk score and a deliverability verdict. The API is stateless and stores no submitted data.
Authentication is handled by the marketplace gateway, so no key management is required in your own code.
Risk scores are computed from weighted flags: invalid syntax scores 100 and short-circuits all other checks, no MX record adds 55, an MX timeout adds 30, a disposable domain adds 75, a role-based address adds 20, a typo adds 10, and a free provider adds 5. The total is capped at 100. The deliverability verdict is derived from the score: high for 0 to 20, medium for 21 to 49, low for 50 to 79, and undeliverable for 80 to 100.
Domain type is classified in precedence order: disposable, then free, educational, government, ISP, and finally business. When passing an email address that contains a plus sign in a query string, the plus must be percent-encoded as %2B, since an unencoded plus is interpreted as a space and will fail syntax validation.
No. It validates syntax, confirms the domain can receive mail through a live MX record lookup, and scores reputation signals such as disposable domains, role-based addresses, and typos. It does not perform live SMTP mailbox verification, so it cannot confirm that a specific mailbox exists. The deliverability verdict and risk score are strong indicative signals, not a delivery guarantee
Each detected flag adds weighted points. No MX record adds 55, an MX timeout adds 30, a disposable domain adds 75, a role-based address adds 20, a typo adds 10, and a free provider adds 5. Invalid syntax scores 100 and skips all other checks. The total is capped at 100, and the deliverability verdict is derived from it. High is 0 to 20, medium is 21 to 49, low is 50 to 79, and undeliverable is 80 to 100.
Disposable or throwaway domains are temporary email services such as Mailinator and ten-minute-mail providers, commonly used to bypass signup gates. The API checks against a list of over 121000 known disposable domains. You can check a single domain with the disposable endpoint or export the full list with the disposable list endpoint.
It runs in two stages. First it checks an exact map of common misspellings of the top providers, which returns high confidence. If there is no exact match, it compares the domain against the known provider list by edit distance, and a single-character difference returns the closest match at medium confidence. If neither stage matches, no suggestion is returned.
A free provider is an independent webmail service such as Gmail, Yahoo, or Outlook. An ISP type is a mailbox bundled with an internet or telecom subscription such as Comcast, BT Internet, or Orange. Both are non-business addresses, and the distinction is useful for analytics and for filtering business signups.
Yes. The batch validation endpoint accepts up to 50 email addresses in a single request and returns a result for each one plus a summary of counts across the batch. There is also a batch domain endpoint that accepts up to 100 domains.
No. The API is stateless and uses no database. Email addresses and domains you submit are processed in memory to produce the response and are not retained. The only data loaded is the static list of disposable domains, providers, and typo mappings.
In a URL query string an unencoded plus sign is read as a space before the API receives it, and a space is not valid in an email address, so the request fails validation. Encode the plus sign as %2B and it will be received correctly.
Each endpoint returns structured JSON data. For example, the Validate Email endpoint provides fields like email, valid, syntax, mx, disposable, role, free_provider, typo_suggestion, email_type, deliverability, and risk_score. Batch endpoints return similar fields for multiple emails or domains, along with summary statistics.
Key fields include "email" for the address checked, "valid" indicating if it's valid, "risk_score" reflecting deliverability risk, and "deliverability" which categorizes the email's likelihood of reaching inboxes. Additional fields provide insights into syntax, MX records, and domain type.
Parameters vary by endpoint. For instance, the Validate Emails Batch endpoint accepts a JSON body with an "emails" array, while the Check Syntax endpoint requires an "email" query parameter. Users can customize requests by providing specific email addresses or domains as needed.
Response data is organized in a JSON format with a "success" boolean, a "data" object containing the results, and a "meta" object with disclaimers. Each result includes relevant fields like email validity and risk assessment, making it easy to parse and utilize.
The API uses a combination of live DNS lookups for MX records, a static list of over 121,000 disposable domains, and a typo map for common misspellings. This multi-source approach enhances data accuracy and reliability for email validation.
Typical use cases include validating email addresses during user sign-ups, cleaning email lists for marketing campaigns, and assessing the quality of leads. Businesses can use the risk score and deliverability verdict to prioritize outreach efforts.
Users can leverage the risk score and deliverability verdict to filter out high-risk emails before sending campaigns. The typo suggestions can help correct common mistakes, while the classification of email types aids in segmenting audiences for targeted marketing.
Data accuracy is maintained through regular updates to the disposable domain list and typo mappings, along with real-time DNS checks for MX records. This ensures that the API provides current and reliable information for email validation tasks.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund