{"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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26051/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26052/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26053/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26054/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26055/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26056/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26057/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26058/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26059/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26060/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26061/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26062/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26063/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26064/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26065/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/13006/advanced+email+deliverability+and+disposable+domain+detection+api/26066/health+check' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 Advanced Email Deliverability and Disposable Domain Detection 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数据。例如,验证电子邮件端点返回字段如电子邮件、有效性、语法、MX、一次性、角色、免费提供者、拼写建议、电子邮件类型、可送达性和风险评分。批量端点提供多个电子邮件或域的类似数据以及汇总统计分析
关键字段包括“电子邮件”(已验证的地址)“有效”(有效性的布尔值)“风险评分”(0-100)“可送达性”(高、中、低、无法送达)和“电子邮件类型”(例如,免费、商业)每个端点都有与其功能相关的特定字段
Parameters vary by endpoint. For example, the Validate Emails Batch endpoint accepts a JSON body with an 'emails' array, while the List Disposable Domains endpoint accepts optional 'page' and 'limit' parameters for pagination. Each endpoint's documentation specifies accepted parameters.
Response data is organized in a JSON format with a 'success' boolean, 'data' object containing the relevant information, and 'meta' for additional context like disclaimers. For batch requests, results are returned in an array with a summary object for overall statistics.
The API uses a static list of over 121,000 known disposable domains, along with live DNS lookups for MX records. Data accuracy is maintained through regular updates to the disposable domain list and by relying on established email validation standards like RFC 5322.
Typical use cases include validating email addresses during user signups, filtering out disposable emails to reduce fraud, and improving email marketing deliverability by identifying role-based or free provider addresses. Businesses can enhance their email lists with accurate data.
Users can analyze the risk score and deliverability verdict to assess email quality. For example, a high risk score indicates potential issues, while a low score suggests a reliable address. Users can also leverage typo suggestions to correct common misspellings before sending communications.
If an endpoint returns partial or empty results, users should check the validity of the input parameters. For batch requests, review the summary statistics to identify how many emails were valid or invalid. Implement error handling to manage cases where no data is returned.