Get Results API

Get results API is ideal for downloading the processed mailing lists from our system. You can use this API after making sure the job you uploaded has finished processing. To check the progress of your job, use our Job Progress API. Once the percentage attribute has reached “100.00” and the stage is set to “completed”, use the following API command to retrieve the results.

It is a simple HTTP POST request with these parameters:

user_API_token: your email verifier account's API Token
job_id: the ID(s) that you were given by batch_process API

You would need to input your API key for your Email Verifier App account into the progress request you are making.

API Endpoint:

Body Parameters:

user_API_token: [Your-API-Token]
job_id: 001

Note: If you uploaded multiple files, you would have been given multiple job IDs. Please submit one job ID in each request you make.

Return Values:
status – Tells you the status of the request made (Values: Success | Failed)
percentage – Tells you the percentage of the job that is completed (Range: 0-100)
stage – Tells you what part of the process the job you uploaded is currently in (Values: In Queue | Processing | Completed)
invalid_result_link – Tells you the location/URL of the invalid results file.
valid_result_link – Tells you the location/URL of the valid results file.
unknown_link – Tells you the location/URL of the unknown results file.

Example JSON Response:

  "status": "success",
  "percentage": "100.00",
  "stage": "Completed",
  "invalid_result_link": "",
  "valid_result_link": "",
  "unknown_link": ""


Looking for batch process API Sample Codes? You should be able to find all major language sample codes including C, cURL, C#, GO, Java, Javascript, NodeJS, Objective-C, PHP, Python, Ruby, Shell and more. Need help with this specific API command or others? Get in touch with our support team.

Can’t find your API Token? See this article – Where can I find API Token? If you are running out of credit and need more credit for your API transactions, please refer to the article on adding API credit to your account.

Note: “user_API_token” is case sensitive. So API is really uppercase and the rest of it is lower case. Failure to do this might result in an error. In addition to this, you MUST have enough API credit to use this API. You can convert your monthly credit to API credit from your control panel through the Real-time API Page.


<< Back to Batch Email Verification API for Developers