Enterprise grade cloud based email verification and data enrichment solution compatible with all programming languages.

DeBounce's API for Email Validation

The most comprehensive API for realtime and bulk validation

Whether you're a developer writing an application that requires the registration of new valid users or a business with a large mailing list, DeBounce can handle the heavy lifting of verifying the validity of your emails, so that you can make a decision on whether or not to dispatch messages to a given address. We currently provide a real-time lookup API which allows you to make an instant informed decision on user validity.
Email is the main means of contact between your business and the customer or the client. DeBounce can help you reach your customers and keep your email sender reputation intact. we provide full end-to-end services for all of your email address validation needs.


Validation API

API Features

Which Checks Does Email Validator Perform?

DeBounce uses a multi-layer checking process, with every single email going through all of these testing and cleaning steps:

  • DNS validation, including MX record lookup
  • Disposable email address detection
  • Misspelled domain detection to prevent Typosquatting
  • Syntax verification (IETF/RFC standard conformance)
  • Temporary unavailability detection
  • Mailbox existence checking
  • Catch-All testing
  • Greylisting detection
  • SMTP connection and availability checking

How to Use DeBounce API

For applications that are in need of real time email address verification (such as account registration workflows) our real time lookup API is the perfect tool for the job. It consists of a single endpoint and requires very little to make use of in a production application. For simplicity and ease of use, we've decided to make lookups available on the GET method.

⌨ Sample Codes

Sample PHP and JavaScript codes to implement API into your apps:

You may also use RapidAPI to connect our validation engine.

📎 Lookup Example

To perform a single lookup on our real-time email verification endpoint, perform a GET request on the following URL:
API_KEY: Mandatory - Your application API key at DeBounce.
EMAIL_ADDRESS: Mandatory - The email address you want to verify.

Each response, includes email validation response. Moreover, your DeBounce remaining balance is included to let you know how many calls you can perform before your credits end.

📎 Sample Response

Here is sample response of API call with detailed explanation of each parameter.

{"debounce":{"email":"[email protected]","code":"5","role":"false","free_email":"true","result":"Safe to Send","reason":"Deliverable","send_transactional":"1"},"success":"1","balance":"1725935"}

email [email] - The email address you are requesting to validate.
code [Integer] - DeBounce validation response code. In order to understand DeBounce results and codes, click here.
role [true, false] - Is the email roles based or not. Role emails such as "[email protected]", "[email protected]" etc. are not suitable to send marketing emails.
free_email [true, false] - Is the email from a free email provider - like Gmail - or not.
result [Invalid, Risky, Safe to Send, Unknown] - The final result of validation process. This response will help you where you should send marketing emails to recipient or not.
reason The reason why the result is given (view full reasons).
send_transactional [0, 1] Is it suggested you send transactional emails to the recipient or not (0: no, 1: yes). Generally, it is suggested to send transactional emails to Valid, Accept-all and Unknown emails.
success [0, 1] Is your call successful or not (0: no, 1: yes). If your credits are zero or you have provided invalid API key, you will receive 0 response.
balance [Integer] Remaining balance of your account after current API call.

If you are going to use this API on a sign-up form, you must consider Deliverable, Accept-all and Unknown statuses as valid, so you do not miss any sign-ups. Another simple way to do that is checking send_transactional parameter. If its value is 1, the email is eligible for being your new user.

Do you need profile photo in output?
If you need only profile photo along with validation results, just add &photo=true at the end of API endpoint. We will bill you 0.2 extra credit for each successful profile photo enrichment.

📎 Getting Your Account Balance

In order to get your account balance, you need to have at least one API. Use one of them to call following API endpoint:
API_KEY: Your application API key at DeBounce.
Response is the number of credits are available in your DeBounce account.

📎 Other Responses

The response you get when your credits are finished:
{"debounce":{"error":"Credits Low", "code":"0"},"success":"0"}
The response you get when the API key is invalid:
{"debounce":{"error":"Wrong API", "code":"0"},"success":"0"}
The response you get when your call rate is high (more than 10 concurrent calls):
{"debounce":{"error":"Maximum concurrent calls reached", "code":"0"},"success":"0"}
If you are using the Public_API key, each user (or unique IP address) can call your API end point 20 times per day. Otherwise, the API output will be:
{"debounce":{"error":"Authentication Failed - The maximum number of calls per day reached."},"success":"0"}