Verify a batch of email addresses | Email API

Returns verified, accept_all or unverified for each address, with the reason. Addresses settled by syntax, a throwaway domain or a domain that can receive no mail are answered without spending a check; meta.checks_spent reports what the batch cost.

38 credits / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

emails*array<>

Up to 25 addresses. Duplicates are collapsed, and addresses on one domain share a single domain check.

Items1 <= items <= 25

source?string

Where the addresses came from. published means the business printed them itself — a free-provider mailbox is then a real contact. guessed means they were generated from a name and a domain, where a free-provider mailbox cannot be right and is rejected without spending a check.

Default"published"

Value in

"published"
"guessed"

curl -X POST "https://example.com/v1/email/verify" \  -H "x-api-key: YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "emails": [      "info@example-dental.com",      "dr.smith@example-dental.com"    ]  }'

{  "data": {    "results": [      {        "email": "info@example-dental.com",        "status": "verified",        "reason": "mailbox_confirmed",        "kind": "role",        "provider": "business"      }    ],    "meta": {      "checks_spent": 2,      "duration_ms": 1840.2    }  }}