Java

You can find the Official ZeroBounce Java API v2 Wrapper:

Official JAVA SDK:

This is a java wrapper class example for the ZeroBounce API v2.

The project has 2 dependencies:

  • Apache HttpClient
  • JSON (org.json)

Either download the dependencies separately and add them to the relevant path or add the following dependencies to your pom.xml file if you're building via Maven (already added if you're cloning this repo):

Validate(email) method:

  • Properties
    Possible Values
  • getEmailAddress()
    The email address you are validating.
  • getStatus()
    Valid
    Invalid
    Catch-All
    Unknown
    Spamtrap
    Abuse
    DoNotMail
  • getSubStatus()
    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_traps
    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
  • getAccount()
    The portion of the email address before the "@" symbol.
  • getDomain()
    The portion of the email address after the "@" symbol.
  • getDidYouMean()
    Suggestive Fix for an email typo or [null]
  • getDomainAgeDays()
    Age of the email domain in days or [null].
  • isFreeEmail()
    [true/false] If the email comes from a free provider.
  • isMXFound()
    [true/false] Does the domain have an MX record.
  • getMXRecord()
    The preferred MX record of the domain or [null].
  • getSMTPProvider()
    The SMTP Provider of the email or [null] (BETA).
  • getFirstName()
    The first name of the owner of the email when available or [null].
  • getLastName()
    The last name of the owner of the email when available or [null].
  • getGender()
    The gender of the owner of the email when available or [null].
  • getCountry()
    The country the IP address is from.
  • getCity()
    The city the IP address is from.
  • getZipcode()
    The zip code the IP address is from.
  • getRegion()
    The region/state the IP address is from.
  • getProcessedAt()
    The UTC time the email was validated.

getCredit() method

  • Properties
    Possible Values
  • getCredits()
    The number of credits left in account for email validation

  //Depending on how you use the API, you might want it to time out faster,
  //for example on a registration screen. 
  //Normally the API will return results very fast, but a small percentage of
  //mail servers take upwards of 20+ seconds to respond. 
  //If the API times out, it will return a status of "Unknown" and 
  //a sub_status of "timeout_exceeded"  

  ZeroBounceApi zeroBounceApi = new ZeroBounceApi("YOUR_API_KEY",TIMEOUT_IN_SECONDS);

  // Get credits and assign to int variable
  int credits = zeroBounceApi.getCredits();

  // validate email and assign result to a ZeroBounceResponse object

  ZeroBounceResponse validation = zeroBounceApi.validate("some@email.com", "some.ip.address can be blank");
  validation.getEmailAddress();
  validation.getStatus();
  validation.isDisposable();
  validation.getCountry();