Response fields

Field	Type	Description
`email`	string	The address, trimmed and lowercased.
`canonical`	string	The inbox it really reaches. Gmail dots and `+tags` are removed: `j.o.hn+promo@gmail.com` becomes `john@gmail.com`. Store this to stop one person creating many accounts.
`did_you_mean`	string	Present when the domain looks like a typo.
`account_type`	string	`work`, `free`, `school`, `relay`, `disposable` or `unknown`.
`role_account`	boolean	`info@`, `support@`, `sales@` and similar shared inboxes.
`disposable`	boolean	A throwaway email service.
`relay`	boolean	A privacy relay such as Apple Hide My Email or Firefox Relay. A real person hiding their address, not a fake.
`deliverable_domain`	boolean or null	The domain can receive mail. `null` if DNS could not be reached.
`mail_provider`	string	`google`, `microsoft`, `zoho`, `proton`, `yahoo`, `apple`, `gateway`, `other` or `none`.
`domain_age_days`	integer	Age of the domain. Present once our background check for this domain has run.
`domain_pattern`	string	Company domains only: `match`, `mismatch` or `learning`. Does the address follow the shape the company uses (for example `first.last`)?
`alias_variants`	integer	Distinct spellings of this same inbox you have checked in the last 90 days (shown when 2 or more). 3 or more suggests one person making many accounts.
`recent_signups`	integer	Unique addresses at this domain checked in about the last 10 minutes, across all customers (shown when 20 or more). A possible bot wave.
`domain_fake_rate`	number	Share of outcomes that other customers reported as fake at this domain (shown once 2 or more customers have reported).
`ip`	object	Present when you sent an `ip`. See below.
`evidence`	array	With `explain: true`. See below.
`human_score`	integer	0 to 100. Higher means more likely a real, unique person.
`verdict`	string	`allow`, `review` or `block`.
`reasons`	array	Reason codes, most important first. See Reason codes.
`check_id`	string	Signed token (about 120 characters). Send it to `/v1/feedback` within 14 days.
`feedback_wanted`	boolean	Present (`true`) when the model is unsure about this address. Reporting its outcome teaches the model the most.
`model`	string	`baseline`, or `learned-v<N>` when the learned model is serving.

`ip` object

Field	Type	Description
`datacenter`	string	Cloud provider that owns the IP: `aws`, `google_cloud`, `oracle_cloud` or `digitalocean`. Real people rarely sign up from a server.
`tor`	boolean	The IP is a Tor exit node.
`signups_from_ip`	integer	Distinct inboxes from this IP at your account in the last hour.
`ignored`	string	Why the IP was not used, for example a private address such as `192.168.1.5`.

`evidence` list (`explain: true`)

Each item shows one signal's effect on the score, in log-odds. Positive means more likely a real person.

"evidence": [
  { "signal": "name_naturalness", "value": 0.496, "impact": 1.489 },
  { "signal": "bias", "value": 1, "impact": 1 },
  { "signal": "dotted_gmail", "value": 1, "impact": -0.4 },
  { "signal": "spf", "value": 1, "impact": 0.3 },
  { "signal": "dmarc", "value": 1, "impact": 0.3 }
]

Response fields

ip object

evidence list (explain: true)

`ip` object

`evidence` list (`explain: true`)