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 ofemail, emails or domain.
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.Response
One plain sentence: how many emails were checked, the verdict counts, the domain status and the charge.
What it costs
quoted_creditsis 1 per unique email, ormax_creditsif that is lower.- When
max_creditsis reached, the remaining emails come back asunknownwith reasoncredit_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.
Errors
See Errors for the full list.
Behaviour
- Batch limit. Up to 1000 emails in
emails, plus one inemail. 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, arerejectedat no charge. - Personal mailboxes. Under the
b2b_outboundpurpose, an address at a personal mail provider isrejectedwith reasonpersonal_email_not_b2b. unknownis notinvalid. 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
incompletearray, each entry withpart(emailordomain) andreason, and the summary says so. Nothing is charged for the part that did not complete. Ask for it again in a new request.

