Global Email Validation & Deliverability API
The Global Email Validation & Deliverability API checks email addresses across syntax, deliverability, and reputation signals, one at a time or in batches of up to 50. Each validation runs an RFC 5322 syntax check, a live MX record lookup to confirm the domain can receive mail, a disposable-domain check against a list of over 121,000 known throwaway providers, role-based address detection,…
Global Email Validation & Deliverability API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Validate | ||
| POST |
Validate Emails (Batch) /validate/batch |
Validates up to 50 email addresses in a single request. Each email runs the full validation pipeline concurrently. Returns an array of per-email results plus a summary block… |
| GET |
Get Risk Score /score |
Returns the risk score and deliverability verdict for a single email, along with the full weighted flag breakdown. Designed for callers who want the scoring logic exposed for… |
| GET |
Check Syntax /syntax |
Validates an email address against RFC 5322 syntax rules only. No DNS lookup is performed. When invalid, the 'reason' field gives the specific failure (e.g. missing @, local part… |
| GET |
Validate Email /validate |
Runs the full validation pipeline on a single email address: RFC 5322 syntax, MX record lookup, disposable-domain detection, role-based detection, free-provider detection, typo… |
| Domain | ||
| POST |
Get Domain Intelligence (Batch) /domain/batch |
Checks up to 100 domains for MX, disposable status, free-provider status, and typo detection in one request. All domains are processed concurrently. Returns per-domain results… |
| GET |
Check Disposable Domain /disposable |
Checks whether a domain is in the bundled disposable/throwaway email domain list (121,000+ domains). Returns the total number of disposable domains currently loaded. |
| GET |
Check MX Records /mx |
Looks up the MX (mail exchanger) records for a domain via DNS. Returns the records sorted by priority. The lookup has a 5-second timeout; on timeout 'mx' is null and 'timeout' is… |
| GET |
List Disposable Domains /disposable/list |
Returns a paginated export of the full disposable domain list. Use 'page' and 'limit' to page through all 121,000+ domains. A page past the end of the data returns an empty… |
| GET |
Get Domain Intelligence /domain |
Full domain intelligence report in one call: MX records, disposable status, free-provider status with provider name, and typo detection (which known domain this is a misspelling… |
| Attributes | ||
| GET |
Check Free Provider /free-provider |
Checks whether a domain is a known free email provider (Gmail, Yahoo, Outlook, etc.) or ISP-bundled mailbox. Returns the provider name when matched. Useful for B2B apps that want… |
| GET |
Classify Email Type /type |
Classifies the email's domain by type, in precedence order: disposable, free, educational, government, isp, or business. 'is_business' is true only when the type is business — a… |
| GET |
Suggest Typo Correction /suggest |
Suggests a correction for a misspelled email domain. Two-stage engine: an exact match against the typo map returns confidence 'high'; an edit-distance-1 match against the… |
| GET |
Check Role Address /role |
Checks whether the local part of an email is a recognised role-based prefix (e.g. info@, support@, admin@). Returns the matched prefix and its category: support, admin,… |
| GET |
List Free Providers /providers |
Returns the full list of known free email providers and ISP-bundled mailboxes, each with its display name and type ('free' or 'isp'). No parameters. |
| GET |
Normalize Email /normalize |
Canonicalises an email address so duplicate signups that bypass basic validation are caught. Lowercases the address, strips +tags for all providers, and additionally strips dots… |
| System | ||
| GET |
Health Check /health |
Returns API status: uptime, version, Node version, and live counts of all loaded datasets (disposable domains, free providers, ISPs, role prefixes, typo map), the total endpoint… |
Global Email Validation & Deliverability API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $9 / month | — |
|
| ULTRA | $29 / month | — |
|
| MEGA | $79 / month | — |
|