Documentation
- Home
- Documentation
OverviewNew to Impressionwise? Thank you for your interest in our services. This document is designed to familiarize you with our account creation and cleansing processes. Sometimes it’s easier to just ask. Please feel free to reach out to us with any questions. 
Create an Account Creating an account with Impressionwise is quick and simple, just follow this link to our new account sign up page. Step 1. Create Account 
Purchase Service Credits Log in to our Client Portal to manage your account. View cleansing credits balance and purchase additional credits. 
Upload your File(s) Transfer your file(s) via HTTP or FTP. Log in to our Client Portal to get additional instructions or begin your file upload. 
Setup Notifications Log in to our Client Portal to manage your account. Create new or multiple automated event notifications. Frequently Asked QuestionsGeneralAre you able to verify and clean all types of emails? Yes, we process emails from around the world and for all types of emails, including B2B, B2C, and top level domains like Yahoo, Hotmail, Gmail and AOL. Can you automate my account? Yes, as long as you have sufficient credits available on your account you can clean files (or use the API) on your own at any time! Do I have to buy a credits package or can I just pay for a single file? You do not have to purchase a credits package, you can simply pay for the exact number of emails in your file if you prefer. However, since we offer volume discounts it is often a better deal to purchase a credits package. In addition, threats are always moving and changing so having extra credits left on your account can be useful for future recleans! What is included with the complimentary evaluation? Our complimentary evaluation is an opportunity to clean a file of up to 100k emails and view a summary report of our findings before you spend any money. The actual results files are not part of the complimentary evaluation, but are available for purchase if desired. How do I sign up for an account? Our sign-up process is easy, simply click here where we will request your company name, billing address, phone, contact name and contact email. We will create an account for you and send a login to our portal where you can make payment, view credits, and upload/download files. Once payment has been received, you can start cleaning! What does the service cost? Please see our pricing page for information about the costs of our service, or feel free to contact us for a quote or additional pricing details. Do you have an API? Yes, we offer access at no extra charge to our real-time, HTTP-based API. Do you have a service to remove only threats? Please contact us if you wish to discuss removing threats from your list without the verification component. Data TransferHow can I send my data to Impressionwise? We offer multiple methods of data transfer, including FTP, API, and our client web portal. Can I have other columns with information in the file I upload? Yes, files with other information are fine as long as the emails are all in the same column and are not in more than one column. When we provide you with the results, that extra information will remain intact. Accepted File Types Currently we accept any form of delineated file txt, csv, zip or rar extensions. If you need assistance with more exotic delimiter formatting, please reach out to our support team. Cleansing ProcessCan you automate my account? Yes, as long as you have sufficient credits available on your account you can clean files (or use the API) on your own at any time! How will I know when my file is done cleaning? Our system will send you an email when the file is complete, letting you know that the results are available for download. Why doesn't the portal show the amount I was invoiced? For convenience, we offer the ability to make payments within our portal. We can send out invoices if you would like one, but it is not required so the portal will not show any specific amount due. You simply enter the amount you want to pay and it will email a receipt once the process is complete! Do my results files stay available in my portal account/on my FTP forever? No! It is very important to download your results promptly and save them elsewhere because our system will automatically delete all files from your account and FTP after 7-10 days. Can I use credits for both file submissions and API calls? Yes! One credit cleans one email address, whether it is in a file or via API. Does a list cleaning last forever? Absolutely not! Depending on the list source and quality, the recommended cleaning intervals can vary. However, in general it is important to be aware that threats are always moving and changing, so cleaning data one time will not protect you forever. AccountingCan you provide an invoice for our company records? Yes of course, once you make your payment we will e-mail a receipt but are happy to also issue an invoice upon request. How do I know when my credits are running low? Our system can notify you when credits are running low via email. We also have an option for weekly credit balance updates via email, and you can purchase additional credits at any time. What methods of payment do you accept? For your convenience, we accept all major credit cards as well as PayPal, bank wires, and ACH transfers. Data Protection and UsageDo you keep, sell or share my data? No we do not. We archive client files and results for 7-10 days for your convenience, but it is automatically deleted after this and you are welcome to delete it sooner if you wish. For additional guidance or any questions you may have, please contact us. Threat Level GuideOur cleansing methodology is focused on the health of your sending network resources. The cleaner the domain and IP the better the delivery.
Threat Intelligence DetailImpressionwise’s data intelligence platform is based on policy-driven rule sets and real-time scanning algorithms that use a multi-layered approach to identify, validate and protect against a wide range of email-based threats. These threats, ranging in severity, are broken down into categories which allows us to provide unprecedented, detailed insight. Brand/ Network Resource/ Deliverability HarmIf your firm is impacted by threats shown below, you need to take immediate action as a laundry list of negative outcomes have potentially already begun, ranging from significant deliverability issues to service termination from your ESP or ISP. If ignored, your brand reputation could be permanently tarnished and easily become associated in some circles with known spam organizations such as SpamHaus’s ROKSO or other similar blacklists. View threats...
Network Resource/ Deliverability ImpactBelow are threats that could cause some significant delivery and reputational issues. At worst, you will experience continued delivery impacts and may be forced to purchase new sending domain and IP resources in order to achieve optimal deliverability. View threats...
Impacted DeliveryThe following threats will result in temporal delivery issues, diminishing your campaign's outreach and effectiveness. Prolonged sending of these threats may result in longer lasting temporary blocks leading to eventual permanent blocking of your emails. There is minimal overall brand and sending resource reputational harm from these items. View threats...
Address VerificationOnce first tiered DNE (do not email) elements (traps, moles, parked sites, etc.) have been removed, the second greatest threat to your message deliverability and eReputation is bounced addresses. Bounces come in many forms, some temporal (mail box full, etc.) while others are permanent notifications (mailbox not found, etc.) Even if you have a trap-free or “clean” list, sending to bounced email addresses can cause great harm as most large ISPs (AOL, Yahoo, Gmail, Hotmail, etc.) use this information in the form of a bounce rate to determine whether or not to accept any future mail from your sending domain.
Parked ResourcesThis site intelligence gives you the leverage of avoiding sending email traffic to millions of unused and parked website domains. Since parked domains have previously not been configured for email by the owner, any recipient is by definition, invalid and being spammed as they receive email in the form of a catch-all/role account.
Dormant AccountsEmail addresses are not permanent. When there has been no login activity for a long period of time, the recipient account is defined by the provider as “inactive” and turned into a form of unknowing collaborator with no non-delivery report (NDR) indicating “no such user” or “mailbox not found” being sent as a response. Thus any email sent during this period of time before account deactivation is assumed, in the collective, as spam and its email signature mapped and used to block any email to other active recipient accounts within the domain. Discretionary (Catch-Alls)*These addresses, commonly referred to as “Accept Alls”, contain a domain-wide setting that accepts every single email received. It can be impossible to determine the validity of the address. These types of email addresses are commonly used in small businesses, and in some cases, the server will accept the emails sent and then bounce it back to the sender. At Impressionwise, we have the ability to determine these addresses are not riddled with spam traps or other severe threats, so a potential bounce is your greatest threat when sending to these recipients. If your list was obtained organically and you are confident in the address's validity, these addresses may be used at your discretion. * Feature only available with Verification Plus Threats service. Need help? If you have any questions, please contact us for assistance. Result CodesTo review the result codes, please select service level/ type provided. Verification Plus ThreatsFull featured service that removes ALL forms of email threats (such as spam traps), eliminates email bounces, protects your sending network resources, keeps you off of third party email blacklists, and enhances the deliverability of your email campaigns while maximizing recipient engagement. To view the Verification Plus Threats result codes. Threat ServiceDesigned to remove specific email threats such as spam traps, oversight seeds, keep you off of third party email blacklists, and enhance the deliverability of your email campaigns while protecting your sending network resources. No email verification nor engagement propensity scans are performed. To view the Threat Service result codes. Need help? If you have any questions, please contact us for assistance. Best PracticesRecommended Usage GuidanceThe guidelines presented below will ensure you are adhering to email best practices, enabling more emails to reach the inbox. As a result, you will mitigate any risk associated with emailing to potentially “bad” addresses and you will experience additional opens, higher click through rates, increased conversions, and more revenue while protecting your online reputation.
Testing and EvaluationAs such, we recommend the following testing methods when declining the recommended use of the Suppress or DNE export in lieu of a customized suppression based on one or more of the individual exports within the Details sub-folder. To ensure a successful evaluation, ensure proper A/B testing procedures are followed. As the name implies, two versions (A and B) are compared, which are identical except for one variation that might affect deliverability and e-reputation of each network’s resources (domain and IP used). Simply stated, in network A use the recommended DNE and for network B make use of the combination of individual suppressions to conduct the desired test. List Profile ReportTo review an example List Profile Report, please select service level/ type provided. Verification Plus ThreatsFull featured service that removes ALL forms of email threats (such as spam traps), eliminates email bounces, protects your sending network resources, keeps you off of third party email blacklists, and enhances the deliverability of your email campaigns while maximizing recipient engagement. To view the Verification Plus Threats data export specifications. Threat ServiceDesigned to remove specific email threats such as spam traps, oversight seeds, keep you off of third party email blacklists, and enhance the deliverability of your email campaigns while protecting your sending network resources. No email verification nor engagement propensity scans are performed. To view the Threat Service data export specifications. Daily Changes SnapshotImpressed with our industry-leading List Profile Report providing the most comprehensive view and insight into your data? Now receive it daily, in the form of a Daily Changes Snapshot informing of daily changes occurring within your list. To combat an ever-changing sending environment, Impressionwise offers our Data Assurance Program designed to guard against a wide range of email-based threats while protecting your online reputation on a daily basis with industry-leading, daily reporting and results. For more information, see Data Assurance Program page or view the Daily Changes Snapshot Need help? If you have any questions, please contact us for assistance. Data Export SpecificationsTo review our data export specification, please select service level/ type provided. Verification Plus ThreatsFull featured service that removes ALL forms of email threats (such as spam traps), eliminates email bounces, protects your sending network resources, keeps you off of third party email blacklists, and enhances the deliverability of your email campaigns while maximizing recipient engagement. To view the Verification Plus Threats data export specifications. Manifest of deliverables contained within compressed file named: Example: SAMPLE_FILE.zip The following export files contain the full row of fields initially provided in comma-delimited or CSV files unless noted otherwise:
All file exports are formatted following the same field structure as provided with an additional field appended named “mxgroup” (Certified and Discretionary) or “threatclass” (Suppress). These file exports are sorted in ascending order (A-Z) using one of the two appended fields. The “mxgroup” field identifies the domain/ organization responsible for handling the reception and acceptance or filtering of email for that particular email address. For more information, see Delivery Group section. Threat ServiceDesigned to remove specific email threats such as spam traps, oversight seeds, keep you off of third party email blacklists, and enhance the deliverability of your email campaigns while protecting your sending network resources. No email verification nor engagement propensity scans are performed. To view the Threat Service data export specifications. Manifest of deliverables contained within compressed file named: Example: SAMPLE_FILE.zip The following export files contain the full row of fields initially provided in comma-delimited or CSV files unless noted otherwise:
Need help? If you have any questions, please contact us for assistance. Country Disposition Code ReferenceThis list states the country names (official short names in English) in alphabetical order as given in ISO 3166-1 and the corresponding two- and three-letter codes. It also shows the five Regional Internet Registry (RIR) service regions - AFRINIC, ARIN, APNIC, LACNIC and RIPE NCC. 
API SpecificationsThe platform is accessible via a secure API/RESTful, secure web service, with service options designed for continuous, real-time data cleansing to provide the most flexibility to fit your business-critical verification needs. Verification/Threats APIOur 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. To view more detail, please see; Verification/Threats API. Threats Only APIOur Hygiene 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 cleansing an individual email address using standard HTTP methods. To view more detail, please see; Threats Only API. Non-Human, Invalid Traffic API (Bots/ Proxies)Protect against high-risk traffic sources (bad actors) and guard against ad-fraud in the form of Non-Human Invalid Traffic (IVT). Our sophisticated machine learning algorithms identify traffic originating from botnets, data center traffic, click farms, proxies, malicious script injectors and hijacked devices, , delivering the highest quality reach. Our invalid traffic API can be seamlessly integrated into your signup or onboarding process with just a single request. This high-speed service is designed for real-time, verification of the IP address or traffic attempting to connect thru to your landing page. To view more detail, please see; Bots API. Need help? Please contact us with any questions. Verification/Threats API OverviewOur 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 SubmissionsOur 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: https://post.impressionwise.com/verifyme.aspx?CODE=000001&PWD=password1&<paramlist> Required Data FieldsParameter's need to be separate by "&"
&CODE= 6 Digit Alpha-numeric, account code provided by Impressionwise = 000001 Optional System Fields&MX= To receive the MX domain information for an email address = 1 Optional Client Pass-thru FieldsParameter's need to be separate by "&" = param1=value1¶m2=value2&...
&fname=test ** Maximum of 20 "other" variables. URL Structure ExampleA properly formatted URL post would resemble the following example: https://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 UsageTo 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 = https://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","CLASS":"INVALID","TTP":2.41} Possible result parameter/values include:
&RESULT= "See below section Result Code section for additional detail" Error HandlingFrom 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, and if the response is the same (another TIMEOUT), we recommend to retry with a higher TIMEOUT value. Example shown below: JSON Response = {"EMAIL":"noexist@testmelink.com","RESULT":"DISCRETIONARY","CLASS":"TIMEOUT","TTP":1.33} If you receive any other response other than those previously shown, please contact support. Result CodesThe 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 Sub-CodesImpressionwise’s threat intelligence platform provides additional insight and detail to a wide range of email-based threats. These threats, ranging in severity, are broken down into classifications.
General Disclaimer: Every reasonable effort is made to locate all known threat and delivery classification elements mentioned herein, yet due to the constantly changing and dynamic nature of the online environment, we can not guarantee the results or deliverable will be free of any/all traps, threat or delivery classification elements identified within this report. While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical errors or technical inaccuracies may exist. Impressionwise does not accept responsibility for any kind of loss resulting from the use of information provided. 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! Threats API OverviewOur Hygiene 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 cleansing an individual email address using standard HTTP methods. Structure and Definition for Inbound SubmissionsOur 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: https://post.impressionwise.com/fastfeed.aspx?CODE=000001&PWD=password1&<paramlist> Required Data FieldsParameters need to be separated by "&"
&CODE= 6 Digit Alpha-numeric, account code provided by Impressionwise = 000001 Optional System Fields&MX= To receive the MX domain information for an email address = 1 Optional Client Pass-thru FieldsParameter's need to be separate by "&" = param1=value1¶m2=value2&...
&fname=test ** Maximum of 20 "other" variables. URL Structure ExampleA properly formatted URL post would resemble the following example as shown below. https://post.impressionwise.com/fastfeed.aspx?code=000001&pwd=askme&email=testme@impressionwise.com&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 UsageTo 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 = https://post.impressionwise.com/fastfeed.aspx?code=000001&pwd=password1&email=noexist@testme.com Upon successful posting of an email address, you can expect to receive the following response. Response = EMAIL=noexist@testmelink.com&RESULT=INVALID&TTP=2.41 Possible result parameter/values include:
&RESULT= "See below section Result Code section for additional detail" Error HandlingFrom 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 (sometimes more than 10 seconds). Due to this possible condition, you will receive a result code of RETRY. Upon reception of this response, please continue your HTTP submissions thru to completion of the entire data set to be submitted.. Once complete, please retry any/all responses with "RETRY" or as shown below: Response = EMAIL=noexist@testmelink.com&RESULT=RETRY&TTP=1.33 If you receive any other response other than those previously shown, please contact support. Result CodesThe recommended guidelines presented below will ensure you are adhering to email best practices, enabling more emails to reach the inbox. As a result, you will mitigate any risk associated with emailing to potentially "bad" addresses and you will experience additional opens, higher click through rates, increased conversions, and more revenue while protecting your online reputation. The recommended guidelines presented below will ensure you are adhering to email best practices, enabling more emails to reach the inbox. As a result, you will mitigate any risk associated with emailing to potentially "bad" addresses and you will experience additional opens, higher click through rates, increased conversions, and more revenue while protecting your online reputation.
Result Specifications
Version 1.0 Result Specifications
Net Protect (NPD) Codes (optional)To address specific deliverability challenges, use the network protected codes provided below to allow for individual classification suppression. NA = Not applicable or address is not a network protected domain or
010 = AppRiver The list of codes above, while infrequent, are subject to change. When a change occurs, generally a notification will be sent prior to any changes go live. Usage and GuidanceNetwork Protected Domains, and the recipients belonging to, are considered to be deliverable. However, the managed SMTP SaaS's are known to be highly collaborative, checking and notifying other leading industry DNSBL sites in real-time if email sent to an anti-spam solution is deemed spam. This section is designed to provide NOTICE ONLY as to which domains are being managed by a particular third party, anti-spam solution and aid in the delivery of your email. Recommended Usage: The anti-spam solution classifications are specifically designed to aid in deliverability challenges. For example, if you are unable to get any email through to any domain protected by a Barracuda appliance due to Barracuda labeling your email as spam, then using the Barracuda export would provide options not normally available. The sender could elect to suppress this domain grouping completely to protect the deliverability to the remaining certified domains within your list. The more popular option would be to take all the network protected domain groupings and send to them after you have sent all other data marked as good or certified to ensure optimal delivery footprint. Country Code Detail (optional)Due to the large number of country codes, a comma-delimited text file has been created for easy access and installation of code library into any existing application. This code library can be found at https://www.impressionwise.com/kb/CountryCodes.txt. The country codes are subject to change. While changes or new changes are rare, please check back monthly to ensure the version you downloaded is current. Domain Origination Note: Sourced from IANA’s database of TLD extensions, proprietary views as provided by domain registrars and Regional Internet Registries (AfriNIC, APNIC, ARIN, LACNIC, RIPE). Assessment is based off the geographic location of the originating IP that the MX record points to establish if domain is of domestic US or international origin. Supplemental confirmation utilizing corresponding RIR's SWIP and Rwhois data where possible. General Disclaimer: Every reasonable effort is made to locate all known threat and delivery classification elements mentioned herein, yet due to the constantly changing and dynamic nature of the online environment, we can not guarantee the results or deliverable will be free of any/all traps, threat or delivery classification elements identified within this report. While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical errors or technical inaccuracies may exist. Impressionwise does not accept responsibility for any kind of loss resulting from the use of information provided. 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! Service Credits Balance API OverviewThe Service Credits Balance API provides a seamless way to check the current balance of your account’s service credits. This API allows users to retrieve their available service credits through a simple, automated process, making it easier to manage and track usage. In this overview, we will guide you through how to access and use the API, including instructions on authentication, endpoint details, and the parameters required to successfully check your service credits balance. By following these steps, you'll be able to integrate the API into your system for real-time updates on your account's service credits. Structure and Definition for Inbound SubmissionsOur 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: https://post.impressionwise.com/creditscheck.aspx?CODE=BBF&PSW=password Required Data FieldsParameters need to be separated by "&"
&CODE= 3 Digit Alpha-numeric, acccount code provided by Impressionwise = BBF. This code can be found in the Client Portal within the API Access section. Parameters and UsageTo retrieve the current service credits balance, simply use the request shown in the sample below substituting the required parameters with provided credentials and email address you want to verify. Sample = https://post.impressionwise.com/creditscheck.aspx?code=BBF&psw=password Upon successful posting, you can expect to receive the following response. Response = CODE=BBF&CREDITS=136,012&TTP=0.41 Possible result parameter/values include:
&CODE= "3 Alpha-numeric, account code assigned by Impressionwise = BBF”. This code can be found in the Client Portal within the API Access section. Error HandlingFrom 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_CREDENTIALS. If you receive any other response other than those previously shown, please contact support. 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! Bulk FTP TransferDesigned for automated, batched submissions of larger volume data sets. This service is designed for those clients who receive data on a regularly scheduled basis with 24/7 access to Impressionwise cleaning services without the wait time of traditional processing in a secure manner. Provided below is the site information required to access via FTP.
Place files within the \ToBeCleaned\ folder to begin cleansing process and results will be placed with a folder named \Cleaned\. Note: Only attempt to only upload delimited (tab, pipe or comma) files with extensions like txt, csv, xls, xlsx, zip, or rar. All other file extensions not listed will not be processed. You may upload a file containing as many fields of information as you wish, yet we require, at a minimum, the email address when scanning the files. Questions? Please feel free to reach out with any questions you may have about our cleansing process or your results, and we look forward to you experiencing the results that truly set Impressionwise apart! Bulk API List SubmissionSending a file by URLThe URL submitted must lead directly to the file and contain the type of input used, as well as any authentication credentials the request needs. The URL should be sent in the request as the input parameter and the input_type should be set to url. Below is an example request:
⇒ request POST (parameters need to be submitted in JSON format)
header "Content-Type: application/json"
url "https://www.impressionwise.com/app/api/create.aspx" data '{
"api_key" : "api key provided by Impressionwise",
}'
"input_type" : "url", "file_name" : "SampleFileAPI.zip", "input" : "url where file is located" Sending data directlyData submitted directly should exist as an array of arrays or an array of objects. The data should be sent in the request as the input parameter and the input_type should be set to data. Below is an example of this request:
⇒ request POST (parameters need to be submitted in JSON format)
header "Content-Type: application/json"
url "https://www.impressionwise.com/app/api/create.aspx" data '{
"api_key" : "api key provided by Impressionwise",
}'
"input_type" : "data", "file_name" : "SampleFileAPI.txt", "input" : '[
[
]'
"PeteyCruiser@testing.com",
],"Petey Cruiser" [
"AnnaSthesia@testing.com",
]"Anna Sthesia" Request ResponseWhen you submit a list via the API, the verification process will start automatically. If your credit balance is insufficient, the verification of your list will fail. You can purchase credits from the portal.
JSON Response
{
"status" : "success",
}
"token" : "b14a7c5c-a104-48c9-a522-22e9f1b79f6", "execution_time" : 10 (value in seconds) If an error occurs, the response will look like the below example:
JSON Response
{
"status" : "fail",
}
"description" : "Error downloading file. Please check it and try again" The failure description may vary depending on the type of fail action. Examples of common failure messages are:
Once you receive a response, you will want to store the value of the token, as it will be used to check the status and eventually retrieve the results. Checking the file statusNow that your list is running, you will need to poll the API and check the status periodically. For the first status check we recommended to wait approximately one minute until our cleaning system begins processing the file. For smaller lists (<50k) polling every 5-10 seconds is acceptable, but for larger lists (>50k) you’ll want to poll less frequently. Request Status
⇒ request GET\
url https://www.impressionwise.com/app/api/status.aspx?token=b14a7c5c-a104-48c9-a522-22e9f1b79f65
JSON Response
{
"status" : "success",
}
"token" : "b14a7c5c-a104-48c9-a522-22e9f1b79f6", "filename" : "SampleFileAPI", "created" : "2018-05-12 20:00:06", "started" : "2018-05-12 20:00:21", "checkpoint" : "exported", "finished" : "2018-05-12 21:52:46", "originalrecords" : 30000, "dedupedrecords" : 30000, "indeterminate" : 0, "invalidrcpts" : 2300, "catchall" : 0, "threat" : 6, "cert" : 20000, "suppress" : 10000, "dormant" : 0 In the response, the status parameter will indicate what the list is currently doing. Typically, status will be the only parameter you will need to watch. However, you may find the additional fields useful for monitoring list progress or to view a breakdown of the results in your list while it’s processing. "status" : This top-level job progress field contains one of four possible conditions. Shown below are these possible conditions and associated descriptions.
"checkpoint" : If you wish to follow the cleansing process in greater detail and the status condition = running then use the checkpoint field to determine job progress. Below are the possible condition descriptions.
Once the status value is set to success, you may begin retrieval of the results. Retrieving the ResultsNow with the cleansing process complete, it’s time to view our findings. Downloading Results
⇒ request GET\
url https://www.impressionwise.com/app/api/download.aspx?token=b14a7c5c-a104-48c9-a522-22e9f1b79f65
The data will be returned in a zip file containing the results. Example: SampleFileAPI.zip The following export files contain the full row of fields initially provided in comma-delimited or CSV files unless noted otherwise:
All file exports are formatted following the same field structure as provided with an additional field appended named “mxgroup” (Certified and Discretionary) or “threatclass” (Suppress). These file exports are sorted in ascending order (A-Z) using one of the two appended fields. The “mxgroup” field identifies the domain/ organization responsible for handling the reception and acceptance or filtering of email for that particular email address. For more information, see Delivery Group section. General Disclaimer: Every reasonable effort is made to locate all known threat and delivery classification elements mentioned herein, yet due to the constantly changing and dynamic nature of the online environment, we can not guarantee the results or deliverable will be free of any/all traps, threat or delivery classification elements identified within this report. While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical errors or technical inaccuracies may exist. Impressionwise does not accept responsibility for any kind of loss resulting from the use of information provided. Questions? Please feel free to reach out with any questions you may have about our cleansing process or your results, and we look forward to you experiencing the results that truly set Impressionwise apart! |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
The recognized authority in email verification and list cleaning services
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