Bulk validation email lists can be deleted using this endpoint. The list can be deleted only if the status of the list is 'ready' or 'completed'. If the status is ‘preparing’ or ‘verifying’, you cannot delete the corresponding list. Once deleted list cannot be recovered back.

Response

HTTP/1.1 200 OK
{
    "job_id": "pb49raml26hlkyuaykopl6wtg58k6vssq5t0w",
    "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

❗️

Deleted list cannot get back

The list cannot be recovered back once the list has been deleted. If the list and results are needed after the list has been deleted, you need to upload and re-verify the list.

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 jobId:

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