Upload

Perform a bulk email validation request.

You can run only one list for validation simultaneously (validate your email lists one by one). Note that the list will automatically start for validation after upload. Your uploaded file will be queued for validation if you already have a running list.

📘

Note

To make use of the API endpoint, please make sure to upload the email list to your own server and provide the full URL of the email list. The URL should start with "https" and end with either ".csv" or ".txt".

Our platform does not support public file sharing platforms such as Google Drive or Dropbox. You are required to utilize your own server for file sharing purposes.

The list must be less than 20MB in size and include a maximum of 200,000 emails.

If successful, you will get a response like this:

JSON

HTTP/1.1 200 OK

{
   "debounce":{
      "list_id":"8620",
      "list_name":"test-list"
   },
   "success":"1"
}

You need to save the list_id parameter to download validation results once the process finishes.
In case there are some errors with your request, you will get a JSON output like:

JSON

HTTP/1.1 200 OK

{
   "debounce":{
      "error":"You have reached the maximum number of API bulk verify requests. Please try after the existing request completes."
   },
   "success":"0"
}

Other Responses

The response you get when the API key is invalid:

JSON

HTTP/1.1 401 Unauthorized

{
   "debounce":{
      "error":"Wrong API",
      "code":"0"
   },
   "success":"0"
}

The response you get when the provided URL is invalid.

JSON

HTTP/1.1 400 Bad Request

{
   "debounce":{
      "error":"URL parameter is not valid."
   },
   "success":"0"
}

You can perform only 10 concurrent calls. Otherwise, you will receive this error:

JSON

HTTP/ 429 Too Many Requests

{
   "debounce":{
      "error":"Maximum concurrent calls reached"
   },
   "success":"0"
}

If you do not have enough credits to start the validation process.

JSON

HTTP/1.1 402 Payment Required

{
   "debounce":{
      "error":"You have exhausted your credits, please add additional credits to continue."
   },
   "success":"0"
}