The result of the bulk validation email list can be downloaded using this endpoint. The bulk validation results can be downloaded only if the verification of the list gets 'completed'. You can download the file in the .csv format, also customise your verification result based on the result codes. The result codes are deliverable, undeliverable, unknown and accept-all.

Response

"Email","Verification Result","Verified At","Syntax Error","ISP","Role","Disposable","Trap"
"[email protected]","deliverable","2021-09-21T09:52:19.734Z","N","Y","N","N","N"
"[email protected]","deliverable","2021-09-21T09:52:19.409Z","N","Y","N","N","N"
"[email protected]","accept-all","2021-09-21T09:52:19.061Z","N","N","Y","N","N"

Response Parameters

Parameter

Type

Description

"Email"

[email]

The email that was verified.

"Verification Result"

[string]

The verified results will be: deliverable, undeliverable, unknown, accept-all

"Verified At"

[date time]

The time at which the email is verified

"Syntax Error"

[0, 1]

Whether the email is syntactically incorrect

"ISP"

[0, 1]

Whether the email is considered a role address. (e.g. "[email protected], [email protected], [email protected], etc.)

"Role"

[0, 1]

Whether the email is hosted by a free email provider like Gmail, Yahoo!, Hotmail etc..

"Disposable"

[0, 1]

Whether this is a temporary email.

"Trap"

[0, 1]

Is this a honey-trap email

"Accept_all"

[0, 1]

Remote host accepts mail at any address.

Other Responses

The response you get when the API key is invalid:

HTTP/1.1 401 Unauthorized
{   
   "result":"Invalid API Key",
   "success": false
}

The response you get when you provide invalid job_id:

HTTP/1.1 400 BadRequest
{
    "result": "Job not found. Invalid jobId",
    "success": false
}

The response you get when your account is under review or restricted:

HTTP/1.1 400 BadRequest
{
    "result": "DOWNLOAD-RESTRICTED",
    "success": false
}

The response you get when you passed the invalid job_id:

HTTP/1.1 400 BadRequest
{
    "result": "Job not found. Invalid jobId",
    "success": false
}

The response you get when you passed the incorrect filter result options:

HTTP/1.1 400 BadRequest
{
  "result": "Invalid filterResult. Please provide correct filterResult options",
  "success": false
}

The response you get when the job is still verifying:

HTTP/1.1 400 BadRequest
{
  "result": "Job is being verified, please wait until it completes.",
  "success": false
}

The response you get when the job is ready to begin verification:

HTTP/1.1 400 BadRequest
{
  "result": "Job is ready for verification, please start verification and download your results once list verified.",
  "success": false
}

The response you get when the job is still being preparing for verification:

HTTP/1.1 400 BadRequest
{
  "result": "Job is being prepared for verification, please start verifying and then download you result.",
  "success": false
}

The response you get when the uploaded list contains invalid data:

HTTP/1.1 400 BadRequest
{
  "result": "List cannot be downloaded, The uploaded list contains invalid data.",
  "success": false
}

The response you get when the job not available:

HTTP/1.1 400 BadRequest
{
  "result": "Job not found.",
  "success": false
}
Language
Authentication