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
}