Create a bulk validation list

post https://api.validto.in/v1/bulk

The email lists in a CSV file format can be uploaded using this endpoint. Your list can have additional data columns and are preserved and downloaded along with the result. Our system analyses your uploaded list automatically and identifies all disposable, syntax and spam trap emails. You can verify your list by enabling auto_verify or else using start endpoint to start verification. Once our system verifies your list, you can easily download your verification result.

Response

HTTP/1.1 200 OK
{
   "job_id": "pb49raml26hlkyuaykopl6wtg58k6vssq5t0w",
   "success": true,   
   "message": "Bulk email verification list has been created"
}

Response Parameters

ParameterTypeDescription
"job_id"[string]The job_id corresponding to the list you have been created
"success"[true, false]Whether the API request call was successful or not.
"message"[string]Describes API result

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 the auto_verify is enabled:

HTTP/1.1 200 OK
{
   "job_id": "pb49raml26hlkyuaykopl6wtg58k6vssq5t0w",
   "success": true,   
   "message": "Bulk email verification list has been created"
}

The response you get when you provide the incorrect file format:

HTTP/1.1 400 BadRequest
{
   "result": "Invalid file data",
   "success": false
}
Language