Download a bulk validation list

GET https://api.validto.com/v1/download

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

Text

"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 hosted by a free email provider like Gmail, Yahoo!, Hotmail etc..
"Role"	[0, 1]	Whether the email is considered a role address. (e.g. "sales@, info@, help@, etc.)
"Disposable"	[0, 1]	Whether this is a temporary email.
"Trap"	[0, 1]	Is this a honey-trap email

Other Responses

The response you get when the API key is invalid:

JSON

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

The response you get when you provide invalid job_id:

JSON

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:

JSON

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

The response you get when you passed the invalid job_id:

JSON

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:

JSON

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:

JSON

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:

JSON

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:

JSON

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:

JSON

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:

JSON

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