Email Verification and Validation API designed
by Developers for Developer

Bouncer Email Verification API is a simple yet powerful way to enhance your IT solution with the most precise and high performing email validation and email verification capabilities. Multiple endpoints both synchronous and asynchronous will meet your most sophisticated email verification needs. As it is super secure and robust, you and your customers data are safe.

💪

Easy to integrate

Integrate in few hours with help of our Team.

🤝

Easy to make a business with

Team that goes the extra mile.

Table of contents

• Generate API Key
• API Reference
• Authentication
• JSON
• Synchronous Real-Time Email Verification API
• Asynchronous Batch Email Verification API
• Available Credits
• Error Handling
• Support

In order to generate your API Key go here or:

• sign up for a Bouncer account here,
• click on the <API> on the left-site menu,
• click Generate API Key button.

Full Bouncer Email Verification API Reference, is available here.
Bouncer REST API Reference provides you all the information about available end-points, their parameters, response json schemas and response examples.
It also lets you test all the endpoints in an easy and safe manner. Just provide your API Key and have all the fun testing our Email Verification API.

All calls made to the Bouncer’s API have to be made using HTTPS.
Even though Bouncer API supports basic authentication, we strongly recommend using x-api-key in a header authentication method.
Available methods of authentication are:

x-api-key in header

“Basic” authentication with api key as password

Whenever a request body is required it should be formatted as JSON and a content type of application/json should be specified.

You can use Bouncer’s Real-time Email Verification API to check email addresses at the moment of entry, and implement it for your sing up forms.
It is a full email verification and email validation method – it not only checks the syntax and domain of the address but also contacts underlying SMTP servers to check deliverability of email addresses.
With Real-Time Email Verification API, Bouncer returns the best possible results that are available within X seconds specified by a customer (default – 10 seconds, maximum – 30 seconds).
Synchronous method, in a form of Real-Time Email Verification API endpoint, is recommended when the speed of verification is of value, as usually this method returns 5% more “unknown” results than full integration using Batch Email Verification API.

Example of usage

Rate Limiting

Real-Time Email Verification API is limited to 100 requests per minute by default. If your use case requires higher limits, please let us know.

If you need to verify multiple email addresses in a batch, you can use our Batch Email Verification API.
Bouncer distributed infrastructure will make sure to get best possible results and retry any verification in case one is required. This method is recommended when the quality of verification is of a value as it characterises the best precision of email validation and the lowest possible amount of “unknown” results.
Default settings allow our customers to verify 100k email addresses per hour, however if your use case requires higher throughput, please let us know and we will be able to adjust your configuration.

Using Batch Email Verification API

You can verify one or multiple email addresses by using Batch Email Verification API, offline manner.
To use this method, provide an array of email addresses, with names if needed (optional), for example:

Please make sure to store requestId as it will be necessary to check status and get results for the request.

Integration flow

There are 2 ways to integrate with Batch Email Verification API:

• using status endpoint, or
• using callback parameter.

Using Status Endpoint

Using Callbacks

Batch size recommendation

Single batch can process up to 250,000 emails, while recommended size would be anything between 1000-10000 emails. Up to 25 batches will be processed in parallel.

Rate Limiting

The Batch Email Verification API is limited to 200 requests per minute by default.

Delete Batch Data

As Bouncer is fully GDPR compliant by design, we also provide an endpoint to delete permanently your requests. Please note that once used, the results associated with the requests will be lost.
To delete your data use:

To check your available balance, you can use this endpoint.

Bouncer’s API makes use of standard HTTP errors to indicate the success or failure of a request. The 2xx series of response codes indicate a success, 4xx indicates an error from the client side, and a 5xx error indicates a server-side error. Here are the HTTP response codes the API utilizes: