The entire API V2 documentation is interactive and can be tested here. To the right side of every endpoint you will see a box with an example request. You can click on the "Try it" button to send a request to the server right from the docs. You will need to provide an API key by clicking the ApiKeyAuth_token blue text.
A single email verification
The verification status.
| Enum Value | Description |
|---|---|
| pending | The verification is pending |
| verified | The verification is verified |
| invalid | The verification is invalid |
The request status. Do not use this field to determine the verification status. Please use verification_status instead to check the verification status
| Enum Value | Description |
|---|---|
| success | The verification was successful |
| error | The verification was unsuccessful |
Whether this is a catch-all email address
| Enum Value | Description |
|---|---|
| false | The email is not a catch-all |
| true | The email is a catch-all |
| pending | The catch-all status is pending |
The number of verification credits available after the verification
{ "status": "success", "email": "example@example.com", "verification_status": "pending", "catch_all": true, "credits": 100, "credits_used": 1 }
If an email takes longer than 10 seconds to verify, the endpoint will return the status as pending. In that case, you may use the /email-verification/:email endpoint to check the status of the verification job.
Alternatively, you can send a webhook_url to receive the results instead of polling the status endpoint.
Requires one of the following scopes: email_verifications:create
Requires one of the following scopes: email_verifications:create, email_verifications:all, all:create, all:all
The Email Verification to create
curl -i -X POST \
https://api.instantly.ai/api/v2/email-verification \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"email": "example@example.com"
}'The Email Verification
The verification status.
| Enum Value | Description |
|---|---|
| pending | The verification is pending |
| verified | The verification is verified |
| invalid | The verification is invalid |
The request status. Do not use this field to determine the verification status. Please use verification_status instead to check the verification status
| Enum Value | Description |
|---|---|
| success | The verification was successful |
| error | The verification was unsuccessful |
Whether this is a catch-all email address
| Enum Value | Description |
|---|---|
| false | The email is not a catch-all |
| true | The email is a catch-all |
| pending | The catch-all status is pending |
The number of verification credits available after the verification
{ "status": "success", "email": "example@example.com", "verification_status": "pending", "catch_all": true, "credits": 100, "credits_used": 1 }
curl -i -X GET \
https://api.instantly.ai/api/v2/email-verification/user@example.com \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'The requested Email Verification
The verification status.
| Enum Value | Description |
|---|---|
| pending | The verification is pending |
| verified | The verification is verified |
| invalid | The verification is invalid |
The request status. Do not use this field to determine the verification status. Please use verification_status instead to check the verification status
| Enum Value | Description |
|---|---|
| success | The verification was successful |
| error | The verification was unsuccessful |
Whether this is a catch-all email address
| Enum Value | Description |
|---|---|
| false | The email is not a catch-all |
| true | The email is a catch-all |
| pending | The catch-all status is pending |
The number of verification credits available after the verification
{ "status": "success", "email": "example@example.com", "verification_status": "pending", "catch_all": true, "credits": 100, "credits_used": 1 }