{"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'
Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Advanced Email Deliverability and Disposable Domain Detection API basta incluir seu token Bearer no cabeçalho Authorization.
| Cabeçalho | Descrição |
|---|---|
Authorization
|
Obrigatório
Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.
|
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
(Economize 2 meses com cobrança anual 🎉)
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.
Cada endpoint retorna dados JSON estruturados Por exemplo o endpoint Validar Email retorna campos como email válido sintaxe mx descartável função provedor_gratuito sugestão_de_typed email_type entregabilidade e risco_pontuação Os endpoints em lote fornecem dados semelhantes para múltiplos emails ou domínios juntamente com estatísticas sumárias
Os campos principais incluem 'email' (o endereço validado), 'valid' (booleano para validade), 'risk_score' (0-100), 'deliverability' (alto, médio, baixo, indelivery) e 'email_type' (por exemplo, gratuito, empresarial). Cada endpoint possui campos específicos relevantes para sua função
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.