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

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:

HTTP/1.1 401 Unauthorized
{   
   "result":"Invalid API Key",
   "success": false
}

The response you get when you provide invalid job_id:

HTTP/1.1 400 BadRequest
{
    "result": "Job not found. Invalid jobId",
    "success": false
}

The response you get when the list is still processing:

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:

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