PYTHON

You can find the Official ZeroBounce Python API v2 wrapper below:

EXAMPLE USAGE

The validate and get_credit methods return objects from which you can easily retrieve properties the properties below.

PROPERTIES AND POSSIBLE VALUES RETURNED BY THE METHODS:

validate method

  • Property
    Possible Values
  • address
    The email address you are validating.
  • status
    valid
    invalid
    catch-all
    unknown
    spamtrap
    abuse
    do_not_mail
  • sub_status
    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
    toxic
    disposable
    role_based_catch_all
  • 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 or [null]
  • 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 or [null].
  • smtp_provider
    The SMTP Provider of the email or [null] (BETA).
  • 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].
  • country
    The country the IP address is from.
  • region
    The state/region the IP address is from
  • city
    The city the IP address is from
  • zipcode
    The Zip Code the IP address is from
  • processed_at
    The UTC time the email was validated

GetCredit method

  • Property
    Possible Values
  • credits
    The number of credits left in account for email validation.
!

Status Code Documentation

Please visit our Status Code Documentation for an explanation of each status.

!

Sandbox Mode

To test out or API without using credits - Please use the emails provided in our sandbox documentation.