Skip to main content
POST
Email Validity Enrich

Overview

POST /api/email/validity/enrich returns the heavier, best-effort context that complements the fast verdict from Email Validity. Where the base call answers “can this mailbox receive mail”, the enrich call answers “what else do we know about this address and its domain”: how old the domain is, where its mail servers are hosted and whether they are on any blocklist, and the public identity footprint tied to the address. It is designed to be called right after the base validity check so a report can fill in progressively. The response contains only the enrichment fields, meant to be merged into the verdict you already have. This endpoint is free. The base Email Validity call already charged for the lookup, so enrichment does not cost additional credits.

Authentication

Works with an API key or an in-app session. For API access, pass your key in the Authorization header.

Request

email
string
required
The email address to enrich.

Example request

Response

Returns only the enrichment fields. Every field is best-effort and may be absent when a source has nothing to report.
email
string
The email address that was enriched (normalized to lowercase).
canonical
string
The provider-canonical form of the address (for example with plus tags and dots normalized).
free_provider
boolean
true when the domain is a consumer mailbox provider (for example Gmail or Outlook).
mx
string[]
The domain’s resolved mail servers (MX hosts) in preference order.
domain_trust
object
The domain’s outbound-security posture: grade (A to F), spf, dmarc, dmarc_policy, mta_sts, tls_rpt, plus the authentication extras dkim, bimi, and dnssec, and the raw DNS records behind them when present.
domain_info
object
Domain registration and DNS posture: registrar, created_at, expires_at, age_days, nameservers, dnssec, and the resolved a records.
mail_servers
object[]
Per-MX infrastructure and reputation. Each entry includes host, ip, asn, org, country, hosting, blocklisted, blocklists, tls_issuer, tls_expires_at, and tls_days_left.
footprint
object
The public identity footprint tied to the address. Fields include gravatar_url and gravatar_profile, registered_services (public services the address is registered on), recovery_emails and recovery_phones (masked recovery hints), a linked google account summary (name, profile_photo_url, gaia_id, active_services, last_profile_edit), and a breaches summary (count, exposed_data, services).
cached
boolean
true when the enriched report was served from cache rather than freshly gathered. Present only on a cache hit.

Example response

Call Email Validity first to get the verdict, then call this endpoint to fill in the fuller report. The base call is what charges credits; enrichment is free.