Skip to main content
POST
/
api
/
v2
/
email-verification
Create email verification
curl --request POST \
  --url https://api.instantly.ai/api/v2/email-verification \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "example@example.com"
}
'
{
  "email": "example@example.com",
  "verification_status": "pending",
  "status": "success",
  "catch_all": true,
  "credits": 100,
  "credits_used": 1
}

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

The verification status.

Available options:
pending,
verified,
invalid
Example:

"pending"

​
status
null | enum<string>

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

Whether this is a catch-all email address

Available options:
true,
false
Example:

true

​
credits
null | number

The number of verification credits available after the verification

Example:

100

​
credits_used
null | number

The number of verification credits used

Example:

1