Skip to main content
POST /v1/validate answers: is this mailbox real, and is this company domain live? Send one email, a list of emails, a domain, or a mix. Use it before sending to addresses you already have.
200
The example shows the shape of a reply. Addresses on documentation domains (example.com, and domains ending in .example, .test, .invalid, .localhost or .local) are returned as rejected with reason reserved_domain and are not charged.

Request

Send at least one of email, emails or domain.
string
One email to check. Up to 320 characters.
string[]
Up to 1000 emails. Each up to 320 characters. Duplicates are checked once.
string
A company domain to check. Up to 253 characters.
string
default:"b2b_outbound"
Why you are asking. One of b2b_outbound, ad_audience, own_customer_enrichment, fraud_check. The call is refused if your workspace has not allowed the purpose.
integer
The most this call may charge. 0 to 100000. Never charged past it.

Response

string
required
The ID of this call. The same value as the X-Request-Id header.
string
required
One plain sentence: how many emails were checked, the verdict counts, the domain status and the charge.
object
required
object[]
required
One entry per unique email. Empty when only domain was sent.
object
Present when domain was sent and its check completed.

What it costs

  • quoted_credits is 1 per unique email, or max_credits if that is lower.
  • When max_credits is reached, the remaining emails come back as unknown with reason credit_cap. They are not charged. Send them again in a new request.
  • If your balance covers only part of the list, the part it covers is checked and the rest come back the same way.
See Credits for how holds and charges work.

Errors

See Errors for the full list.

Behaviour

  • Batch limit. Up to 1000 emails in emails, plus one in email. Duplicates are checked and charged once.
  • Refused before any paid check. Malformed, disposable, placeholder (such as test@) and reserved-domain addresses, and addresses on a domain that does not resolve, are rejected at no charge.
  • Personal mailboxes. Under the b2b_outbound purpose, an address at a personal mail provider is rejected with reason personal_email_not_b2b.
  • unknown is not invalid. It means the check gave no answer. Do not drop the address on that alone.
  • Emails and domain are two checks. When both are sent and one does not complete, the reply still carries the other. It adds an incomplete array, each entry with part (email or domain) and reason, and the summary says so. Nothing is charged for the part that did not complete. Ask for it again in a new request.