Upload

You can run only one list for validation at the same time (validate your email lists one by one). Note that the list will automatically start for validation after upload. If you already have a running list, your uploaded file will be queued for validation.
The list must be less than 20MB in size and includes a maximum of 200,000 emails.

If successful, you will get a response like this:

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:

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:

HTTP/1.1 401 Unauthorized

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

The response you get when the provided URL is invalid.

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:

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.

HTTP/1.1 402 Payment Required

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