This endpoint allows you to upload a bulk email validation list. It accepts the file in .csv (comma separated values) format. The supported size of the file is 10Mb. The number of emails in a file must be within 5 lakhs. The additional columns in the csv file will be retained. The emails are verified instantly when the auto_verify is enabled. If the auto_verify is disabled, the email list is prepared and ‘ready’ for verification, you can start verification using start endpoint.

Successful Response

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

Response Parameters

Parameter

Type

Description

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": "r374aki32rnatv868nntpxloc7dkilszc3eu",
   "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
Authentication
Query