ZeroBounce

App · Email · 2 actions

Validate email addresses with ZeroBounce and check how many validation credits your account has left.

Get Remaining Credits

Return the number of email-validation credits remaining on the connected ZeroBounce account. Useful for checking the balance before running a large validation job.

Inputs

None.

Outputs

creditsnumber
Number of email-validation credits remaining
Example output
{
  "credits": 12345
}

Verify Email

Validate a single email address and return its deliverability status. The status is one of valid, invalid, catch-all, unknown, spamtrap, abuse, or do_not_mail, alongside a sub_status, mailbox and domain details, and any name, gender, or location ZeroBounce could append. Each call consumes one ZeroBounce credit.

Inputs

Email addressemailtextRequired
The email address to validate, for example jane@example.com.
IP addressip_addresstext
Optional. The IPv4 or IPv6 address the email signed up from, used to append geolocation to the result. Leave empty if you don't have it.

Outputs

accounttext
The local part of the address (before the @)
citytext
City (if resolved)
countrytext
Country (if resolved)
did_you_meantext
A suggested correction for a likely typo
domaintext
The domain part of the address (after the @)
domain_age_daystext
Age of the domain in days
emailtext
The email address that was validated
firstnametext
First name ZeroBounce associated with the address
free_emailtrue/false
Whether the domain is a free email provider
gendertext
Gender ZeroBounce associated with the address
lastnametext
Last name ZeroBounce associated with the address
mx_foundtext
Whether an MX record was found ("true"/"false")
mx_recordtext
The MX record the domain resolves to
processed_attext
When ZeroBounce processed the request
raw_responseobject
The full original ZeroBounce validation payload
regiontext
Region (if resolved)
smtp_providertext
The SMTP provider serving the domain
statustext
Deliverability status: valid, invalid, catch-all, unknown, spamtrap, abuse, or do_not_mail
sub_statustext
More specific reason behind the status
zipcodetext
ZIP code (if resolved)
Example output
{
  "account": "flowerjill",
  "city": null,
  "country": null,
  "did_you_mean": null,
  "domain": "aol.com",
  "domain_age_days": "9692",
  "email": "flowerjill@aol.com",
  "firstname": "Jill",
  "free_email": true,
  "gender": "female",
  "lastname": "Stein",
  "mx_found": "true",
  "mx_record": "mx-aol.mail.gm0.yahoodns.net",
  "processed_at": "2026-07-23 15:23:23.123",
  "raw_response": {
    "account": "flowerjill",
    "address": "flowerjill@aol.com",
    "city": null,
    "country": null,
    "did_you_mean": null,
    "domain": "aol.com",
    "domain_age_days": "9692",
    "firstname": "Jill",
    "free_email": true,
    "gender": "female",
    "lastname": "Stein",
    "mx_found": "true",
    "mx_record": "mx-aol.mail.gm0.yahoodns.net",
    "processed_at": "2026-07-23 15:23:23.123",
    "region": null,
    "smtp_provider": "yahoo",
    "status": "valid",
    "sub_status": "",
    "zipcode": null
  },
  "region": null,
  "smtp_provider": "yahoo",
  "status": "valid",
  "sub_status": "",
  "zipcode": null
}

On this page