SINGLE EMAIL VALIDATOR - REAL TIME (V2)

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. This endpoint can be called asynchronously and is currently not rate limited.

To test out or API without using credits - Please use the emails provided in our Sandbox Mode (v2)

The response time for our API is between one second and 30 seconds. Since API's are meant to be fast by nature, we limit the amount of time we spend validating an email address. So if we encounter a slow mail server or a mail server with a greylisting algorithm you will get an unknown result. You can always re-validate those conditions, uploading a file to the bulk email validator.

On average 96-98% of all domains will return in 1 to 5 seconds, there are a handful of domains that run off Postfix/Dovecot that have a 20 second connection time for real-time validations and a very small fractional percentage of other domains that are very slow to respond to SMTP inquiries. All the major ISP will return in 1 to 3 seconds, which is usually the majority of most email distribution.

- GET /V2/VALIDATE

API DEFAULT URL: https://api.zerobounce.net/v2/validate
API U.S.A. URL*: https://api-us.zerobounce.net/v2/validate

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. This endpoint can be called asynchronously and is currently not rate limited.

*This endpoint uses servers located within the United States. By utilizing this endpoint, you acknowledge and consent to your data being processed on servers in the United States.

URL Parameters

  • Parameter
    Description
  • email
    The email address you want to validate
  • ip_address
    The IP Address the email signed up from (Can be blank, but parameter required)
  • api_key
    Your API Key, found in your account.
  • timeout
    The duration (3 - 60 seconds) allowed for the validation. If met, the API will return unknown / greylisted. (optional parameter)
If you want to call the API from your browser to test it, all you need to do is to replace the API KEY with your key:
  • https://api.zerobounce.net/v2/validate?api_key=replacewithyours&email=valid@example.com&ip_address=156.124.12.145
  • https://api-us.zerobounce.net/v2/validate?api_key=replacewithyours&email=valid@example.com&ip_address=156.124.12.145

TO VERIFY AN EMAIL ADDRESS, USE THE FOLLOWING CODES FOR THE FOLLOWING LANGUAGES:

Successful Response

    {
        "address":"flowerjill@aol.com",
        "status":"valid",
        "sub_status":"",
        "free_email":true,
        "did_you_mean":null,
        "account":"flowerjill",
        "domain":"aol.com",
        "domain_age_days": "8426",
        "smtp_provider":"yahoo",
        "mx_record":"mx-aol.mail.gm0.yahoodns.net",
        "mx_found": "true",
        "firstname":"Jill",
        "lastname":"Stein",
        "gender":"female",
        "country":"United States",
        "region":"Florida",
        "city":"West Palm Beach",
        "zipcode":"33401",
        "processed_at":"2017-04-01 02:48:02.592"
        }
    
Error Response

    {"error":"Invalid API Key or your account ran out of credits"}
    // Failure response sample using the API with either method Get
    

THE API WILL RETURN THESE RESULTS IN A JSON FORMAT USING THE "VALIDATE" METHOD.

JSON 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].
  • 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].
  • 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.

API Validation V2 Rate Limits

We allow a maximum of 50.000 requests in 10 seconds (validations) for the https://api.zerobounce.net/v2/validate and https://api-us.zerobounce.net/v2/validate* before temporarily blocking for 1 minute.

Bad API key requests to https://api.zerobounce.net/v2/validate and https://api-us.zerobounce.net/v2/validate*200 times in 1 hour will result in a temporary block for 1 hour.

*This endpoint uses servers located within the United States. By utilizing this endpoint, you acknowledge and consent to your data being processed on servers in the United States.