Skip to main content
Both the single verification endpoint (GET /v1/verify) and the bulk results endpoint (GET /v1/bulk/{job_id}/results) return an EmailVerificationResponse object. It contains the overall status, a detailed substatus, a plain-English explanation, the detected email_provider, domain-level signals (mx_record, is_domain_catch_all, is_secure_email_gateway), three boolean enrichment flags that tell you whether the address is disposable, role-based, or from a free provider, and a confidence score for safe results.

​
Fields

​
string
The email address that was verified. Reflects the address from your request.
​
string
Overall verification result. One of safe, risky, invalid, or unknown. See status values below for descriptions.
​
string
The specific reason behind the status. Provides more granular detail than status alone. See substatuses below for all 14 possible values.
​
string
A plain-English sentence describing the verification outcome. Suitable for logs, dashboards, and debugging.
​
string
The email service provider associated with the address domain. Examples: Google Workspace, Gmail, Microsoft Outlook.
​
string | null
The main mail server the domain uses to receive email. null if the domain has no mail server configured — when that happens, substatus will be no_mx_records.
​
boolean | null
true if the domain accepts mail for any username (catch-all). null if we could not determine whether the domain is catch-all.
​
boolean
true if the domain is protected by a secure email gateway — Proofpoint, Mimecast, Barracuda, or Trend Micro.
​
boolean | null
true if the address belongs to a known temporary or disposable email service (e.g., Mailinator, Guerrilla Mail). false if it is not. null if the provider could not be determined.
​
boolean | null
true if the address is a generic role-based account such as info@, support@, or sales@. These addresses typically map to shared inboxes rather than individual recipients. null if it could not be determined.
​
boolean | null
true if the address is from a free consumer email provider such as gmail.com, yahoo.com, or hotmail.com. null if the provider could not be determined.
​
integer | null
How confident we are in the result, on a 0–100 scale. Returned for safe results only — use the score to balance yield vs bounce rate when filtering deliverable addresses. null for risky, invalid, and unknown results; use status and substatus for those instead.

​
Status values

​
Substatuses

Each substatus maps to a parent status. The table below lists all 14 substatus values, their parent status, and their meaning.