Skip to main content
POST
Create email verification

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

The Email Verification to create

The Email Verification to create

email
string
required

The email address to verify

Example:

"example@example.com"

webhook_url
string

A webhook URL to receive the verification results. If the email verification takes more than 10 seconds we will send the results to this URL.

Example:

"https://example.com/webhook"

Response

The Email Verification

A single email verification

email
string
required

The email address to verify

Example:

"example@example.com"

verification_status
enum<string>
required
read-only

The verification status.

Available options:
pending,
verified,
invalid
Example:

"pending"

status
null | enum<string>
read-only

The request status. Do not use this field to determine the verification status. Please use verification_status instead to check the verification status

Available options:
success,
error
Example:

"success"

catch_all
read-only

Whether this is a catch-all email address

Available options:
true,
false
Example:

true

credits
null | number
read-only

The number of verification credits available after the verification

Example:

100

credits_used
null | number
read-only

The number of verification credits used

Example:

1