Impressionwise Email Verification and Spam Trap Removal

Documentation


Verification/Threats API Overview

Our API can be seamlessly integrated into your signup or onboarding process with just a single request. This high speed processing option is designed for continuous, real-time, data cleansing for verifying an individual email address using standard HTTP POST methods and JSON formatted responses.

Structure and Definition for Inbound Submissions

Our API requires you to authenticate each individual request. Below is an example of a basic URL structure request, just substitute with the provided account, associated password along with any optional parameters.

Structure: http://post.impressionwise.com/verifyme.aspx?CODE=000001&PWD=password1&<paramlist>

Required Data Fields

Parameter's need to be separate by "&"

&CODE= 6 Digit numeric, acccount code provided by Impressionwise = 000001
&PWD= Alpha-numeric, security code provided by Impressionwise = password1
&EMAIL= Recipient email address to be submitted for processing = noexist@testme.com
&TIMEOUT= Maximum time allowed to process value represented in seconds, range = 3-60 (default 15)

Optional Client Pass-thru Fields

Parameter's need to be separate by "&" = param1=value1&param2=value2&...

&fname=test
&lname=me
&addr1=123 sw 150 ave
&addr2=
&city=miami
&state=FL
&zip=33222
&country=USA
&phone=3057645678
&gender=m
&optinsite=www.impressionwise.com
&optindate=2010-02-10
&optinip=34.44.55.32
&other1=
&other2=

** Maximum of 20 "other" variables.

URL Structure Example

A properly formatted URL post would resemble the following example:

http://post.impressionwise.com/fastfeed.aspx?code=000001&pwd=askme&email=testme@impressionwise.com&timeout=10&fname=test&lname=me&addr1=123 sw 150 ave &addr2=&city=miami&state=FL&zip=33222&country=USA&phone=3057645678&gender=m&optinsite=www.impressionwise.com&optindate=2010-02-10&optinip=34.44.55.32

Parameters and Usage

To verify an email address simply use the request shown in the sample below substituting the required parameters with provided credentials and email address you want to verify.

Sample = http://post.impressionwise.com/verifyme.aspx?CODE=000001&PWD=password1&EMAIL=noexist@testme.com&TIMEOUT=10

Upon successful posting of an email address, you can expect to receive the following response.

JSON Response = {"EMAIL":"noexist@testmelink.com","RESULT":"SUPPRESS","TTP":2.41}

Possible result parameter/values include:

&RESULT= "See below section Result Code section for additional detail"
&TTP= "Time it took to process value represented in seconds"
&EPS= "Future for Engagement Propensity Score, numeric value between 1-100, if parameter is present"
&DPS;TTP= ”Future Delivery Preference Score, numeric value between 1-120, if parameter is present”

Error Handling

From time to time you may experience an API error. It is important to watch out for these and handle them appropriately. Specifically, if your submission contains an invalid account code or password the result response would be WRONG_PSW.

Additionally, it has been our experience that with some smaller email hosts it is not uncommon for their reply to take an excessive amount of time to respond (more than 15 seconds). Due to this possible condition, we allow you to specify a maximum timeout period in which you are willing to wait for a response. If this value is exceeded you will receive a result code of DISCRETIONARY. Upon reception of this response in addition to TTP value that exceeds the TIMEOUT value specified, please continue your HTTP submissions thru to completion of the entire data set to be submitted. Once complete, please retry any/all responses with meeting this condition with a higher TIMEOUT value. Example shown below:

JSON Response = {"EMAIL":"noexist@testmelink.com","RESULT":"DISCRETIONARY","TTP":1.33}

If you receive any other response other than those previously shown, please contact support.

Result Codes

The recommended guidelines presented below will ensure you are adhering to email best practices, enabling more emails to reach the inbox. While Impressionwise is known for providing industry leading levels of detail, we have combined over 240 threat metrics into 3 intuitive result codes for ease of use.

Classification Description/ Guidance
Result Code
Do Not Email. All addresses in this file should be entirely removed from your active mailing list as they have been classified as “Do Not Email”. These addresses contain various reputation and deliverability threats and should be avoided. You may use this list as a suppression file to be uploaded to your ESP for ease of use. This code contains the following threat classifications: Trap, Mole, Quarantine, Seed, Key, Invalid, Parked Site, and Dormant Account classified recipients. SUPPRESS
Discretionary. We are able to conclude that these email addresses do not represent a threat and are safe to send to. These addresses commonly referred to as “Accept All’s”, contain a domain-wide setting that does not allow for anyone to conclusively verify that these addresses are deliverable without the sending of an email message. Therefore, we suggest sending in small batches initially in order to remove any invalid recipients. Once all the invalids have been removed, this list can be combined with the Certified or Safe list for normal sending. DISCRETIONARY
Certified Safe to Send. Email address with no known reason to expect a delivery failure or harm to email senders online reputation. CERTIFIED

Questions? Please feel free to contact us with any questions or specific customization requirements you may have regarding our automated, data cleansing feed services to ensure a successful evaluation or use of our services and let the results speak for themselves!


The recognized authority in email verification
and list cleaning services

100.9 billion

18.4 trillion

6.6 billion

Emails Processed Data Points Analyzed Threats Discovered

With an average of 117,545 new email-based threats found each month, Impressionwise makes it easy for potential clients to evaluate our list cleaning services by offering a complimentary scan and report for a sample set of your data to illustrate the benefits of our services.

Try it Now


Experience the difference for yourself. Try our free list analysis!
Your online reputation should not be a game of risk versus reward. Give me a chance to help set you apart from the competition...
Get protected against a wide range of email-based threats. Let me explain to you how...
Experience unparalleled insight into your data. Click on chat so we can guide you through our industry leading report...
On the go? So are we. With Impressionwise, you always have instant access to your data at your fingertips. Let’ chat so I can showcase...
Whether you are interested in real time or batch cleansing, our flexible service will suit your needs. Questions, I can help...
Still not convinced? Let’s discuss or opt for a free trial and see why we are the leading email hygiene company in the industry.
Don’t put your resources at risk. Let Impressionwise protect your reputation and enhance your campaign outreaches. Click chat to continue this discussion...
Getting started is as easy as 1,2,3. Create your account today and see why so many others trust Impressionwise. Still not convinced, let’s chat...
►►
◄◄