BATCH EMAIL VALIDATOR - REAL TIME (V2)

Consult the API Rate Limits. If you're looking to do single email validations, please use our single email validator endpoint.

If you're looking to upload files with emails greater than 200 at a time without any rate limiting restrictions, please use our ,Bulk File Management Endpoints which also includes anti-greylisting as an added benefit.

This endpoint can take up to 70 seconds to return the results of the entire batch. We currently don't have an SDK for this endpoint, but SDK's are available for our other endpoints.

- POST /V2/VALIDATEBATCH

API URL:

api.zerobounce.net/v2/validatebatch
api-us.zerobounce.net/v2/validatebatch
api-eu.zerobounce.net/v2/validatebatch

Below you will find the instructions on how to use our API, it's very easy to use and requires SSL. The API requires that you have an active credit balance and will never consume a credit for any unknown result.

URL Parameters

Parameter
Description

api_key
Your API Key
email_batch
[Array of Objects], Format:{"email_address": "valid@example.com","ip_address": "1.1.1.1"}
timeout
The duration (10 - 120 seconds) allowed for the validation. If met, the API will return unknown / greylisted. (optional parameter)
activity_data
[true/false] If set to ‘true,’ Activity Data information will be appended to the validation result. (optional parameter)
Learn more about Activity Data.
verify_plus
[true/false] If set to ‘true,’ Verify+ validation method will be used to get the validation result. It overrides the account settings made regarding Verify+. (optional parameter)
Learn more about Verify+.

EXAMPLE POST REQUEST


    {
      "api_key":"Your API Key",
          "email_batch":[
              {"email_address": "valid@example.com","ip_address": "1.1.1.1"},
              {"email_address": "invalid@example.com","ip_address": "1.1.1.1"},
              {"email_address": "disposable@example.com","ip_address": null}
          ],
      "activity_data" : true,
      "verify_plus": true
  }

TO USE THIS ENDPOINT, USE THE CODE EXAMPLES BELOW FOR THE DESIRED LANGUAGE:

Successful Response


    {
      "email_batch": [
          {
              "address": "john.doe@zerobounce.net",
              "status": "valid",
              "sub_status": "",
              "free_email": false,
              "catchall_domain": true,
              "did_you_mean": null,
              "account": "johndoe",
              "domain": "zerobounce.net",
              "domain_age_days": "3431",
              "active_in_days": "30",
              "active_first_seen": "2026-02-25",
              "smtp_provider": "g-suite",
              "mx_found": "true",
              "mx_record": "aspmx.l.google.com",
              "firstname": "dan",
              "lastname": "cotet",
              "gender": "male",
              "country": null,
              "region": null,
              "city": null,
              "zipcode": null,
              "processed_at": "2026-06-18 07:05:00.033"
          },
          {
              "address": "invalid@example.com",
              "status": "invalid",
              "sub_status": "mailbox_not_found",
              "free_email": false,
              "did_you_mean": null,
              "account": null,
              "domain": null,
              "domain_age_days": "9692",
              "active_in_days": "365",
              "active_first_seen": "2026-02-25",
              "smtp_provider": "example",
              "mx_found": "true",
              "mx_record": "mx.example.com",
              "catchall_domain": false,
              "firstname": "zero",
              "lastname": "bounce",
              "gender": "male",
              "country": null,
              "region": null,
              "city": null,
              "zipcode": null,
              "processed_at": "2020-09-17 17:43:11.830"
          },
          {
              "address": "disposable@example.com",
              "status": "do_not_mail",
              "sub_status": "disposable",
              "free_email": false,
              "did_you_mean": null,
              "account": null,
              "domain": null,
              "domain_age_days": "9692",
              "active_in_days": "365",
              "active_first_seen": "2026-02-25",
              "smtp_provider": "example",
              "mx_found": "true",
              "mx_record": "mx.example.com",
              "catchall_domain": false,
              "firstname": "zero",
              "lastname": "bounce",
              "gender": "male",
              "country": null,
              "region": null,
              "city": null,
              "zipcode": null,
              "processed_at": "2020-09-17 17:43:11.830"
          }
      ],
      "errors": []
  }

Error Response


    {
      "email_batch": [],
      "errors": [
          {
              "error": "Invalid API Key or your account ran out of credits",
              "email_address": "all"
          }
      ]
    }

THE API WILL RETURN A JSON OBJECT WITH 2 ARRAY VALUES, "EMAIL_BATCH" AND "ERRORS" USING THE "BATCHVALIDATE" METHOD.

The email_batch property will be an array of validated results and the errors array will be an array of errors encountered during batch vaidation, if any.

JSON Properties

Properties
Description

email_batch
[Array] An Array of validated emails
errors
[Array] An Array of errors encuontered, if any

email_batch Properties

Properties
Description

address
The email address you are validating.
status
[valid, invalid, catch-all, unknown, spamtrap, abuse, do_not_mail]
sub_status
[alternate, antispam_system, greylisted, mail_server_temporary_error, forcible_disconnect, mail_server_did_not_respond, timeout_exceeded, failed_smtp_connection, mailbox_quota_exceeded, exception_occurred, possible_trap, role_based, global_suppression, mailbox_not_found, no_dns_entries, failed_syntax_check, possible_typo, unroutable_ip_address, leading_period_removed, does_not_accept_mail, alias_address, role_based_catch_all, disposable, toxic]
account
The portion of the email address before the "@" symbol.
domain
The portion of the email address after the "@" symbol.
did_you_mean
Suggestive Fix for an email typo
domain_age_days
Age of the email domain in days or [null].
active_in_days
Last activity date that is less than [30/60/90/180/365/365+]
active_first_seen
The first date when we detected a signal (activity) for this email
free_email
[true/false] If the email comes from a free provider.
mx_found
[true/false] Does the domain have an MX record.
mx_record
The preferred MX record of the domain
smtp_provider
The SMTP Provider of the email or [null] [BETA].
catchall_domain
- [true/false or null] Is the domain name a catch-all (the domain email server responds with valid to any SMTP checks and emailing to an invalid might not bounce)?
firstname
The first name of the owner of the email when available or [null].
lastname
The last name of the owner of the email when available or [null].
gender
The gender of the owner of the email when available or [null].
city
The city of the IP passed in or [null]
region
The region/state of the IP passed in or [null]
zipcode
The zipcode of the IP passed in or [null]
country
The country of the IP passed in or [null]
processed_at
The UTC time the email was validated.