Email Verification & Threat Removal API

API Endpoint

The API is available via a secure HTTPS endpoint:

https://post.impressionwise.com/verifyme.aspx

For compatibility, HTTP access may also be supported; however, HTTPS is strongly recommended to ensure data encryption in transit and alignment with industry-standard security best practices.

Performance & Reliability

The API is hosted on a robust, load-balanced, redundant infrastructure designed for high availability and consistent performance. Automated monitoring and failover mechanisms minimize downtime and ensure reliable handling of variable traffic volumes.

Configurable Processing Level

The Verification & Threats API allows you to balance processing speed and verification depth using the configurable TIMEOUT parameter. This flexibility enables optimization based on your use case—whether prioritizing low-latency responses during real-time signups or deeper analysis for higher-risk or batch data processing.

Lower timeout values return results more quickly but may rely on partial signals, while higher timeout values allow for more comprehensive validation when mail hosts require additional response time.

For guidance on selecting the optimal balance between speed and accuracy, refer to:
https://impressionwise.com/blog/API-Speed-vs-Accuracy.html

Authentication & Request Structure

All API requests require authentication using a unique account code and password. To obtain your assigned API credentials, please contact Impressionwise support. Once you have your credentials, each request must follow the standard structure shown below:

Base Request Structure

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

Required Parameters

The following parameters are required for each API request and must be included in the query string, separated by the & character.

The required authentication and request parameters (such as CODE or PWD) may be submitted either in the URL query string or, optionally, in the request header. The system will first inspect the URL for all required fields; if any parameter is not found, it will then check the request header. For example, PWD=XXXXX can be included in the URL or in a header to support secure processing.

Optional System Parameters

In addition to required parameters, the API supports optional system parameters that can provide extra information or modify the request behavior.

Optional Client Pass-Through Fields

Client-defined parameters may be passed through the request and returned in the response for correlation purposes.

Sample supported fields include:

fname, lname, addr1, addr2, city, state, zip, country,
phone, gender, optinsite, optindate, optinip,
other1 – other20

Note: A maximum of 20 other fields is supported.

Sample Request

Below is an example of a complete API request along with a sample JSON response illustrating the returned data structure.

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

Sample JSON Response

{
"EMAIL": "noexist@testmelink.com",
"RESULT": "SUPPRESS",
"CLASS": "INVALID",
"TTP": 2.41
}

Response Fields

Each API response includes the following fields, which describe the verification result, threat classification, and processing time associated with the submitted email address.

Error Handling & Timeouts

The API provides explicit error codes and timeout responses to indicate invalid credentials or delayed server replies, along with recommended steps for handling and retrying affected requests.

If invalid credentials are supplied, the API returns:

RESULT = ACCT_INVALID_CREDENTIALS

If account credential supplied are correct yet the account is set to inactive, the API returns:

RESULT = ACCT_INACTIVE

If missing required fields for processing, the API returns:

RESULT = MISSING_REQD_FIELDS

If processing more than 15 requests per second, the API returns:

RESULT = MAXATTEMPTS_REACH

In cases where a mail server does not respond within the specified timeout, the following response is returned:

{
"EMAIL": "noexist@testmelink.com",
"RESULT": "DISCRETIONARY",
"CLASS": "TIMEOUT",
"TTP": 1.33
}

Rate Limiting Controls

This API employ’s connection-level rate limiting controls to mitigate abuse and protect backend resources. Specifically, our system restricts the number of simultaneous open connections per client IP address to a maximum of 50 concurrent connections. If a client attempts to open a connection beyond this threshold (for example, the 51st simultaneous connection), the additional connection is rejected, and returns a 503 Service Temporarily Unavailable response.

This mechanism helps prevent denial-of-service conditions, safeguards backend infrastructure, and ensures fair resource usage across all clients. It operates transparently and does not impact normal traffic within the defined limits.

Timeout Handling Guidance

• Continue submitting remaining records to completion
• Retry affected records after processing completes
• If timeouts persist, increase the TIMEOUT value for subsequent retries

If you receive any unexpected responses beyond those documented here, please contact Impressionwise Support.

Result Code Guidance

To simplify integration while preserving analytical depth, Impressionwise consolidates over 240 threat indicators into three intuitive result codes. This approach enables fast decision-making while supporting email best practices, improved inbox placement, and sender reputation protection.

Primary Result Codes

Classification Sub-Codes

Impressionwise provides detailed sub-classifications to help refine sending decisions based on risk profile and behavioral intelligence.

Certified & Conditional Classifications

Discretionary Sub-Classifications

Suppression-Level Threats

General Disclaimer. Every reasonable effort is made to identify known threat and delivery classifications. However, due to the constantly evolving nature of the online ecosystem, Impressionwise cannot guarantee results will be entirely free of all potential threats or delivery risks. While care has been taken to ensure accuracy, Impressionwise assumes no responsibility for losses arising from reliance on this information.

Support & Customization

For questions, interpretation guidance, or custom implementation strategies, Impressionwise Support is available to help ensure optimal results from your data cleansing workflows.