from
TRY NOW

API

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.

Integration

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.

📎 Lookup Example



To perform a single lookup on our real-time email verification endpoint, perform a GET request on the following URL:

https://api.debounce.io/v1/?api=API_KEY&email=EMAIL_ADDRESS&append=APPEND
API_KEY: Mandatory - Your application API key at DeBounce.
EMAIL_ADDRESS: Mandatory - The email address you want to verify.
APPEND: Optional - Set this value true if you want DeBounce to detect email owner name and photo. Please note each successful enrichment request costs you 1 extra credit. So, if you set this true, you will pay 2 credits for each successful call. You will not pay for unsuccessful data enrichment requests.

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.

In case data append is NOT activated
{"debounce":{"email":"[email protected]","code":"5","role":"false","result":"Safe to Send","reason":"Deliverable","send_transactional":"1"},"success":"1","balance":"1725935"}

In case data append is activated
{"debounce":{"email":"[email protected]","fullname":"Mohsen Javdani","firstname":"Mohsen","lastname":"Javdani","photo":"https://lh3.googleusercontent.com/a-/AAuE7mChkYGFq_3AAacjlUZaQqfKnfiawLJno1EkDzWMoQ","code":"5","role":"false","result":"Safe to Send","reason":"Deliverable","send_transactional":"1"},"success":"1","balance":"1725941"}

Parameters:
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.
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.

Extra output if you set append parameter true:
fullname [string] - The email address owner full name.
firstname [string] - The email address owner first name.
lastname [string] - The email address owner last name.
photo [string] - The email address owner profile image URL.

📎 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:

https://api.debounce.io/v1/?api=API_KEY&action=balance
API_KEY: Your application API key at DeBounce.

Response is the number of credits are available in your DeBounce account.