API Wrappers

  //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();
      

  var ZeroBounceApi = new ZeroBounceApi(apiKey)
  ZeroBounceApi.apiKey
  ZeroBounceApi.getCredits()
  ZeroBounceApi.validate("some@email.com", "some.ip.address can be blank")
      

  from zerobounce import ZeroBounceAPI

  zba = ZeroBounceAPI('yourapikey____________')
  print zba.get_credits()
  resp1 = zba.validate('flowerjill@aol.com','123.145.124.12')
  
  print resp1
  {
  "address":"flowerjill@aol.com",
  "status":"valid",
  "sub_status":"",
  "free_email":True,
  "did_you_mean":None,
  "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"
  }
  
  print resp.firstname
  Jill
  
  print resp2.status
  valid
      
      

  <?php
  require_once("zerobounce.php");
  
  $zba = new ZeroBounceAPI('YOUR_API_KEY');
  
  //print the credit balance
  print_r($zba->get_credits());
  
  //instantiate a validation object following a call to 
  //validate and print individual elements
  $validation = $zba->validate('email@address.com', 'IP can be blank');
  echo $validation['address'];
  echo $validation['status'];
  print_r($zba->validate('email@address.com', 'IP'));
  ?>
      

  use nickdnkZeroBounceEmail;
  use nickdnkZeroBounceResult;
  use nickdnkZeroBounceZeroBounce;
  
  // You can modify the timeout using the second parameter. Default is 15.
  $handler = new ZeroBounce('my_api_key', 30);
  
  $email = new Email(
  
      // The email address you want to check
      'some-email@domain.com',
  
      // and if you have it, the IP address - otherwise null or omitted
      '123.123.123.123'
  
  );
  
  try {
  
      // Validate the email
      $result = $handler->validateEmail($email);
  
      if ($result->getStatus() === Result::STATUS_VALID) {
  
          // All good
  
          if ($result->isFreeEmail()) {
  
              // Email address is free, such as @gmail.com, @hotmail.com.
  
          }
  
          /**
          * The user object contains metadata about the email address
          * supplied by ZeroBounce. All of these may be null or empty
          * strings, so remember to check for that. 
          */
          $user = $result->getUser();
  
          $user->getCountry();
          $user->getRegion();
          $user->getZipCode();
          $user->getCity();
          $user->getGender();
          $user->getFirstName();
          $user->getLastName();
  
      } else if ($result->getStatus() === Result::STATUS_DO_NOT_MAIL) {
  
          // The substatus code will help you determine the exact issue:
  
          switch ($result->getSubStatus()) {
  
              case Result::SUBSTATUS_DISPOSABLE:
              case Result::SUBSTATUS_TOXIC:
                  // Toxic or disposable.
                  break;
  
  
              case Result::SUBSTATUS_ROLE_BASED:
                  // admin@, helpdesk@, info@ etc; not a personal email
                  break;
  
              // ... and so on.
  
          }
  
      } else if ($result->getStatus() === Result::STATUS_INVALID) {
  
          // Invalid email.
  
      } else if ($result->getStatus() === Result::STATUS_SPAMTRAP) {
  
          // Spam-trap.
  
      } else if ($result->getStatus() === Result::STATUS_ABUSE) {
  
          // Abuse.
  
      } else if ($result->getStatus() === Result::STATUS_CATCH_ALL) {
  
          // Address is catch-all; not necessarily a private email.
  
      } else if ($result->getStatus() === Result::STATUS_UNKNOWN) {
  
          // Unknown email status.
  
      }
  
      /*
      * To find out how to use and react to different status and
      * substatus codes, see the ZeroBounce documentation at:
      * https://www.zerobounce.net/docs/?swift#version-2__v2__
      */
  
  } catch (
ickdnkZeroBounceAPIError $exception) {
  
    // Something happened. Perhaps a bad API key or insufficient credit.
  
  }