Delete a bulk validation list

GET https://api.validto.com/v1/bulk/{job_id}

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

JSON

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:

JSON

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

The response you get when you provide invalid jobId:

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
}