List Evaluator Public API documentation

Test our email validator

Find out how ZeroBounce delivers better bulk email list verification with 99% accurate results. Upload a CSV or TXT file and ZeroBounce will evaluate your list for free.

While this is a free public service, there are limitations in place to ensure that once you evaluate the list, you also validate it over ZeroBounce. The List Evaluator public API is available unlimited use to those who spend credits validating with us.

Using List Evaluator via the API provides results in real time and enables you to get an overview of your email list before submitting the list via our comprehensive email validation. The results are returned in percentages and a minimum of 100 emails need to be submitted for evaluation.

The API endpoint URL is below, please replace your_api_key with your API key from your account.

If you are not sure where to find your API key, you can generate one, or use an existing key. If you’re uncertain on how to interact with our API, please refer to our expanded API documentation.

If you need guidance on using the API, please don’t hesitate to get in touch with our 24/7 customer support team.

API Endpoint:

POST https://bulkapi.zerobounce.net/v2/listevaluator/

The Body content type needs to be multipart/form-data.

Body Data

  • Parameter
    Description
  • file
    csv or txt file. Byte array contents for the submitted file. The content's header is type of "text/csv". (Required)
  • api_key
    Your API Key, found in your account. (Required)
  • email_address_column
    The column index of the email address in the file. Index starts from 1. (Required)

ENDPOINT RESPONSE

Successful Response (Status Code: 201 CREATED)
Error Response (Status Code: 4xx, 5xx)

GET https://bulkapi.zerobounce.net/v2/listevaluator/<file_id>/?api_key=api_key

URL Query Params

  • Parameter
    Description
  • file_id
    File ID provided in the response from the POST request (Required)
  • api_key
    Your API Key, found in your account. (Required)

ENDPOINT RESPONSE

Successful Response (Status Code: 200 OK)
# File is Processing
Successful Response (Status Code: 200 OK)
# File is Completed
Error Response (Status Code: 4xx, 5xx)

LIST EVALUATOR RATE LIMITS

Our list evaluator is a free service and it is subject to rate limits in proportion to the amount of credits purchased for your account. A minimum of 100 emails need to be submitted for evaluation.

Bad API key requests to https://bulkapi.zerobounce.net/v2/listevaluator/ 200 times in 1 hour will result in a temporary block for 1 hour.