Making an API call is really easy. All you need is:

• An Email Address to clean (email)
• Your API Key (api_key)

There are 3 main APIs each take exactly the same parameters as either POST or GET data:

REAL-TIME CLEAN (ListWise Premium Plan Users Only): https://api.listwisehq.com/clean/realtime.php

The real-time clean API does the FULL ListWise cleaning processing in real-time. This is the same level of thorough cleaning as when you upload email lists into the ListWise application. This API is best for online registration, opt-in and signup forms – that require an instant verification of a single email address. Using the real-time API can save you from many problems and limits the need to re-clean your data in the future. This API will cost you 1 credit for each unique email request.

DEEP CLEAN: https://api.listwisehq.com/clean/deep.php

The deep clean API does the FULL ListWise cleaning processing, with a delayed result. This is the same level of thorough cleaning as when you upload email lists into the ListWise application. This API is best for cleaning email addresses in bulk. Unlike, the REAL-TIME CLEAN, the result is not immediate. You will need to call back the API to get the email clean result, after a few minutes. This API will cost you 1 credit for each unique email request.

QUICK CLEAN: https://api.listwisehq.com/clean/quick.php

The quick clean API is 100% FREE (as long as you have an active ListWise account with at least 1 credit available). This API is guaranteed to give you a result within 1000ms so is excellent for any place where you need a near instant validation of an email.
The quick clean API current performs the following email checks:
Address syntax and RFC checks, Domain checks (DNS and MX Servers), Typo fixing, Spam-trap checking, Free-mail checking and No-reply checking. It does not, however, do a real-time SMTP handshake with the email provider to check the validity of each individual email address. So the result would not be as accurate as the DEEP CLEAN or REAL-TIME clean.

All APIs return JSON format with the following fields:

Field	Value
email	The email address being cleaned (may be different from the original email passed in for example if typo’s have been fixed)
email_status	invalid – This address is invalid (fails syntax or RFC checks) no-reply – This address is not expected to receive any reply emails spam-trap – This address has been detected as a spam-trap bad-mx – The mail server is not present or is not configured correctly bounced – This address does not exist and will bounce back catch-all – The mail server accepts both fake and real addresses suspicious – This address has been rejected or deferred after multiple checks without a confirmed result. It may bounce unknown – The mail server returns an unexpected result. This address may bounce disposable – Disposable email addresses that are used for fake registration and one-time use. role-based – These types of addresses are generating spam complaints and affecting deliverability as they are received by more than one person.  clean – This address is clean processing – This address is currently being processed, you should check back again within 5-10 minutes Additional statuses for the Real-Time API only. rejected –The Mail server rejected our cleaning attempt. deferred – The mail server deferred our cleaning request at this time. timeout – The mail server took too long to respond to our request.
free_mail	yes / no: this address is a free-mail address
typo_fixed	yes / no: this address has had typo’s fixed
error_code	1: Not enough parameters 2: Invalid user 3: No credits available 4: API communication error
error_msg	error message matching the error_code

Example API Call (RealTime Clean) :

https://api.listwisehq.com/clean/realtime.php?email=someone@example.com&api_key=YourApiKey

Example API Call (Deep Clean):

https://api.listwisehq.com/clean/deep.php?email=someone@example.com&api_key=YourApiKey

Example API Call (Quick Clean):

https://api.listwisehq.com/clean/quick.php?email=someone@example.com&api_key=YourApiKey

Example API Response:

{“email”:”someone@example.com”,”email_status”:”clean”,”free_mail”:”no”,”typo_fixed”:”no”}

Q. Is there any kind of throttle on the APIs?

A. One simultaneous connection per IP.