Delete a bulk email list

This endpoint allows you to delete the uploaded bulk validation email list. The bulk email list can be deleted only if the list is ‘ready’ for verification or verification ‘completed’. The list cannot be deleted if the list is undergoing verification or processing. Once deleted, the list cannot be undone.

❗️

List deletion cannot be undone

The list and its results once deleted cannot recovered back. If the lists and results are needed, you need to upload and verify the list again.

Successful Response

JSON

HTTP/1.1 200 OK
{
    "job_id": "r374aki32rnatv868nntpxloc7dkilszc3eu",
    "success": true,
    "message": "List will be deleted"
}

Response Parameters

Parameter	Type	Definition
job_id	[string]	Your list's jobId, you needs to delete
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:

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 the list is still processing:

JSON

HTTP/1.1 400 BadRequest
{
    "result": "List is being processed, and cannot be deleted.",
    "success": false
}

The response you get when the list not found:

JSON

HTTP/1.1 400 BadRequest
{
    "result": "List not found, may be already deleted.",
    "success": false
}