Email Validity Enrich
Lookups
Email Validity Enrich
Second-stage enrichment for the email validity report: domain registration, per-server infrastructure, and identity footprint.
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 theAuthorization header.
Request
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.The email address that was enriched (normalized to lowercase).
The provider-canonical form of the address (for example with plus tags and
dots normalized).
true when the domain is a consumer mailbox provider (for example Gmail or
Outlook).The domain’s resolved mail servers (MX hosts) in preference order.
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 registration and DNS posture:
registrar, created_at, expires_at,
age_days, nameservers, dnssec, and the resolved a records.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.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).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.