Response reference

Email verifier response

Returned by GET /email-verifier. The checks are in data.email, the public pages where the address appears are in data.sources, and phone numbers are in data.phone_data when you set enrich_mobile=true.

Fields

Field	Type	Description
`email`	string	The verified address. Empty when the domain is disposable.
`status`	string	The detailed outcome. See Status values.
`result`	string	The deliverability verdict. See Result values.
`score`	integer	Confidence score. Higher means more likely to be deliverable.
`smtp_provider`	string or null	Mail provider detected from the domain's MX records, such as `Google`.
`mx.records`	array of strings or null	MX host names of the domain.
`mx_check`	boolean	The domain has MX records.
`smtp_check`	boolean	`true` when the domain has MX records, the same as `mx_check`. It doesn't show whether the mailbox exists; use `status`.
`smtp_server`	boolean	Same value as `smtp_check`.
`accept_all`	boolean	The domain's mail server accepts mail for any address (catch-all), so a mailbox can't be confirmed.
`greylisted`	boolean	The mail server temporarily deferred the check.
`block`	boolean	The mail server blocked or refused the check. Usually comes with status `unknown`.
`gibberish`	boolean	The part before `@` looks randomly generated.
`disposable`	boolean	The domain belongs to a disposable email provider.
`webmail`	boolean	The domain belongs to a webmail provider, such as Gmail or Outlook.
`regex`	boolean	The address is syntactically valid.
`whois`	object	Domain registration: `registrar_name`, `referral_url`, `created_date`. Each can be null.

data.sources is described in Sources. When a valid address has no public source, it contains one entry that points to the address's page on Tomba. data.phone_data is described in Phone.

Status values

`status`	`result`	Meaning
`valid`	`deliverable`	The mailbox exists and accepts mail.
`accept_all`	`risky`	The server accepts mail for any address, so this mailbox can't be confirmed.
`invalid`	`undeliverable`	The mailbox doesn't exist.
`unknown`	`risky`	The check was inconclusive: the server blocked it (`block` is `true`) or didn't answer.
`disposable`	empty	The domain is a disposable email provider. `email` and `result` are empty strings.

Compare status case-insensitively: some responses return Valid. Webmail addresses don't have their own status; check the webmail field.

Result values

`result`	Meaning	Suggested action
`deliverable`	Mail to this address should be delivered.	Send.
`undeliverable`	Mail to this address will bounce.	Remove it from your list.
`risky`	Delivery can't be confirmed: a catch-all domain or an inconclusive check.	Send with care, or verify again later.
empty	The address is on a disposable domain.	Treat it as undeliverable.

How results are produced

A request that returns disposable or unknown isn't charged; see Credits and usage.
When the mailbox check fails, the request returns 408 with type proxy_error; see Errors.

Example


Code
{
    "data": {
        "email": {
            "email": "jane.doe@wordpress.org",
            "result": "deliverable",
            "status": "valid",
            "score": 99,
            "smtp_provider": "Google",
            "mx": { "records": ["aspmx.l.google.com"] },
            "mx_check": true,
            "smtp_server": true,
            "smtp_check": true,
            "accept_all": false,
            "greylisted": false,
            "block": false,
            "gibberish": false,
            "disposable": false,
            "webmail": false,
            "regex": true,
            "whois": {
                "registrar_name": "MarkMonitor Inc.",
                "referral_url": "http://www.markmonitor.com",
                "created_date": "2003-01-11T00:00:00Z"
            }
        },
        "sources": [
            {
                "uri": "https://wordpress.org/about/",
                "website_url": "wordpress.org",
                "extracted_on": "2023-03-15",
                "last_seen_on": "2025-01-10",
                "still_on_page": true
            }
        ]
    }
}

Last modified on October 7, 2026

Company response Email count response