{"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'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 Comprehensive Email Verification and Deliverability API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
(年度计费可节省 2 个月 🎉)
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.
每个端点返回结构化的 JSON 数据。例如,验证邮件端点提供诸如 email、valid、syntax、mx、disposable、role、free_provider、typo_suggestion、email_type、deliverability 和 risk_score 等字段。批量端点为多个邮件或域名返回类似字段,以及汇总统计数据
关键字段包括“email”用于检查的地址,“valid”表示其有效性,“risk_score”反映可交付性风险,以及“deliverability”用来分类电子邮件到达收件箱的可能性。附加字段提供语法、MX记录和域类型的见解
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.