--- title: "Response Fields" description: "Every field the SignupSieve email validation API returns, including the ip object and the evidence list, explained." canonical_url: "https://signupsieve.pages.dev/docs/response-fields" --- > Index of every page on this site: [llms.txt](https://signupsieve.pages.dev/llms.txt) # 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 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. ```json "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 } ] ``` ## Sitemap See the full [sitemap](https://signupsieve.pages.dev/sitemap.md) for all pages.