To start

HardBounceCleaner allows you to check the validity of your emails by sending in a list or using the real-time API directly in your application.  Here are the steps to start:

Step 1: Create a free account HardBounceCleaner

HardBounceCleaner offers checking emails 100 free for opening the account. If you need more, find on the homepage our price.

Click here to create your free account.

Step 2: Validate your emails

You are now ready to download a list (csv or txt file) to check emails and / or to incorporate real-time API. Feel free to send to support any of your questions.

How HardBounceCleaner works

HardBounceCleaner will check the validity of your emails using the SMTP protocol. It's the same one you use without necessarily knowing when you send your emails. HardBounceCleaner does not send email to this check, but will examine step by step the remote system, such as Gmail. Who will tell us if the email request does exist. In addition to this final check, we check the existence of the upstream area, where an associated SMTP server in this field, and more.

While this approach may seem simple, it is actually surprisingly complex that we begin to want to check more than 10 emails. The email providers are implementing a lot of measures to make sure that the request is legitimate. This is why many companies use our system and benefit from our experience.

Terminology: Email status

Result Description

Valid

The email is valid, you can send it without problems

Invalid

The email is invalid, delete it from your database, or deny registration if you use the real-time API

Unknown

The remote server provider does not respond in time, meaning that we have not received a clear answer. We advise you not to send such emails

Email qualification

Result Description

Free

The supplier is free (Gmail, Yahoo, etc ...) is a good sign if your database is BtoC

Role

Users of this email has a role, for example @contact or @info or @posmaster. This means that this email is not addressed to anyone in particular, avoid sending this kind of emails.

Disposable

The email is valid, but disposable after a short time it will not be possible to contact the user.

Risky

This email address seems to belong to an organization that tracks spam, it is very risky to send and no real person is behind this email

Security and Privacy

Your email is sensitive, yours and should remain private and secure. HardBounceCleaner not share or never rent this information to others. All information that pass through HardBounceCleaner is encrypted via SSL, it is the same protocol used for secure financial transactions.

During a check list, once your file downloaded and validated, it will be encrypted and a unique password will be asked to open it. Similarly, when using the real-time API, the emails you want to check go through https (SSL) and are therefore not readable in the clear over the network.

Check a list

Step 1: Import a list

Your file containing the emails must be in CSV format ideally with as column separator and the comma as utf8 encoding. Make sure you have a file (csv or txt) that meets the following conditions:

  • the mailing list should contain an email per line
  • The first line should contain a field named but it is optional
  • the email addresses must be in the same column

You can have additional columns in addition to the email column, the file will be returned to you with more information valid email. To send your file, click "Browse" or just drag the file into faitee part provided for this purpose.

Step 2: Format Control

A compliance check will then be made to your file for the presence of emails and see if the format is correct. Once this step, you will be notified by email and you can then start checking the file.

Step 3: Start the verifications

To start checking the file you must click Start, of the audit is completed an email is sent to you. If you ever do not have enough credits to fully check the file, processing will stop when your credits will be 0. You can then purchase the missing and start a new verification credits.

Step 4: Retrieve the list

Once verification is complete you can download the file with different information or your entire list or only a list of valid emails, invalid, or those whose status is unknown. For each row, are added columns: StatusFreeRole DisposableRisky Warning, your list is encrypted and protected by a password, it will appear at the click on the button "Download". Once you have recovered your list, we recommend you delete it from the queue.

Real-time API

With the realtime API HardBounceCleaner, you can integrate the verification email in your own applications. This allows you for example to check whether your users well informed before a correct email registration.

API Keys

An account is required to generate keys for the API, it is these that will give you access to the service. We recommend that you create as many keys as sources, for example if you have 2 websites, create 2 keys with these two domain names. Add the domain name or IP address used to make a request to the API. Every week we will generate for you protect a file by API keys, containing the list of emails checked in this way. You can then download these lists, and then delete them.

The request

To make a request to the API, just call the GET protocol this URL:
https://www.hardbouncecleaner.com/api/v1/[email protected]&timeout=10&language=en

Replace [email protected] with the email to check, add an X-HardBounceCleaner-Key header line, and the API key You will find on the API page examples in the following languages: cURL, PHP, Node.js, jQuery, Python, Ruby, Java, Objective-C, .NET, Windows 8

The answer

A json table will be returned with these variables:

Variable Possible value

success

true, false
If you have an authentication problem or exhaustion of your credit, success return false

error_message

default : null
When success is false an error message in your language will be sent.

email

The email you want to check

role

true, false
If the user of the email has a role, eg [email protected]

free

true, false
If the email provider is free, eg gmail.com

disposable

true, false
If the email provider is disposable, ie if the email has a short service life

risky

true, false
If the email provider is a fight against spam service and not a real user

did_you_mean

default : null
If for example the email to verify the API is [email protected] will send you a proposal as [email protected]

status

valid, invalid, unknown
The status of the email, if for example all your credits have been exhausted status unknown will then always returned, not to block your application.