Use ZeroBounce's email validation API to increase your email marketing ROI!
Remove invalid email addresses from your list using our unique email verification scrubbing system to prevent email bounces.
Our API will protect your reputation by reducing your bounce rate, remove bad emails to improve overall inbox delivery metrics, and we have a 98% accuracy guarantee.
Below you will find the documentation on our API, it's very easy to use and requires SSL.
The response time for our API is between one second and 70 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 inquires. All the major ISP will return in 1 to 3 seconds, which is usually the majority of most email distribution.
The API will return these results in a JSON format using the "Validate" method.
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, 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.
region- The region/state of the IP passed in.
zipcode- The zipcode of the IP passed in.
country- The country of the IP passed in.
Processed_at- The UTC time the email was validated.
{"address":"[email protected]","status":"catch-all","sub_status":"","free_email":false,"did_you_mean":null,"account":"adam.baxter","domain":"chsinc.com","domain_age_days":"9926","smtp_provider":"proofpoint","mx_found":"true","mx_record":"mxa-002ae201.gslb.pphosted.com","firstname":"adam","lastname":"baxter","gender":"male","country":"Australia","region":null,"city":null,"zipcode":null,"processed_at":"2023-03-14 14:22:07.415"}
curl --location --request GET 'https://zylalabs.com/api/497/zerobounce+email+validation+api/419/[email protected]&ip_address=1.1.1.1' --header 'Authorization: Bearer YOUR_API_KEY'
{"found":false,"active_in_days":null}
curl --location --request GET 'https://zylalabs.com/api/497/zerobounce+email+validation+api/420/email+activity' --header 'Authorization: Bearer YOUR_API_KEY'
{"address":"[email protected]","status":"Catch-All","sub_status":"","account":"testing","domain":"zerobounce.net","disposable":false,"toxic":false,"firstname":null,"lastname":null,"gender":null,"location":null,"creationdate":null,"processedat":"2022-10-24 13:37:58.725","country":"Australia"}
curl --location --request GET 'https://zylalabs.com/api/497/zerobounce+email+validation+api/421/email+validation+with+ip+version+one' --header 'Authorization: Bearer YOUR_API_KEY'
{"address":"[email protected]","status":"Catch-All","sub_status":"","account":"testing","domain":"zerobounce.net","disposable":false,"toxic":false,"firstname":null,"lastname":null,"gender":null,"location":null,"creationdate":null,"processedat":"2022-10-24 13:41:17.955"}
curl --location --request GET 'https://zylalabs.com/api/497/zerobounce+email+validation+api/422/email+validation+version+one' --header 'Authorization: Bearer YOUR_API_KEY'
| Header | Description |
|---|---|
Authorization
|
[Required] Should be Bearer access_key. See "Your API Access Key" above when you are subscribed. |
No long-term commitment. Upgrade, downgrade, or cancel anytime.
Each endpoint returns JSON data related to email validation and activity. The Email Validation endpoints provide details such as validation status, account information, and geolocation data, while the Email Activity endpoint offers insights into subscriber engagement metrics like opens and clicks.
Key fields include "address," "status," "sub-status," "account," "domain," "firstname," "lastname," "gender," and "processed_at." These fields provide essential information about the email's validity and associated user details.
The response data is structured in a JSON format, with each field representing specific attributes of the email validation or activity. For example, the "status" field indicates the validation outcome, while "firstname" and "lastname" provide user identification.
The Email Validation endpoints provide validation status, domain age, and user details, while the Email Activity endpoint offers engagement metrics such as opens and unsubscribes over specified timeframes, enhancing targeting and personalization.
Users can customize requests by specifying the email address for validation in the Email Validation endpoints. For the Email Activity endpoint, users can define the time range (30, 90, 180, or 365 days) to gather engagement insights.
The data is sourced from various email servers and engagement metrics collected from user interactions. ZeroBounce employs advanced algorithms and machine learning to ensure high accuracy and reliability in email validation.
Typical use cases include improving email marketing campaigns by validating subscriber lists, reducing bounce rates, and enhancing targeting through engagement insights. This helps marketers optimize their strategies and increase ROI.
Users can leverage the returned data to clean their email lists, identify potential spam traps, and personalize marketing efforts based on user demographics. For example, knowing the "gender" and "location" can help tailor content to specific audiences.
To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
Service Level:
100%
Response Time:
844ms
Service Level:
100%
Response Time:
765ms
Service Level:
100%
Response Time:
660ms
Service Level:
100%
Response Time:
901ms
Service Level:
91%
Response Time:
152ms
Service Level:
100%
Response Time:
205ms
Service Level:
100%
Response Time:
655ms
Service Level:
100%
Response Time:
990ms
Service Level:
100%
Response Time:
639ms
Service Level:
100%
Response Time:
596ms
Service Level:
100%
Response Time:
814ms
Service Level:
100%
Response Time:
1,078ms
Service Level:
100%
Response Time:
15ms
Service Level:
100%
Response Time:
11,971ms
Service Level:
100%
Response Time:
816ms
Service Level:
100%
Response Time:
1,882ms
Service Level:
100%
Response Time:
680ms
Service Level:
100%
Response Time:
559ms
Service Level:
100%
Response Time:
282ms
Service Level:
100%
Response Time:
105ms