Create a bulk validation list

post https://api.validto.com/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.

🚧

Limits

In our Bulk Validation API, you can manage up to 500 lists awaiting verification and concurrently verify up to 100 lists.

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
}

The response you get when you exceed the maximum limit of list uploads.

HTTP/1.1 400 BadRequest
{
    "success": false,
    "message": "The maximum number of lists has been reached."
}

The response you get when you hit the maximum limit of concurrent list verifications.

HTTP/1.1 400 BadRequest
{
    "success": false,
    "message": "The maximum number of active verification lists has been reached."
}
Language