IPQS
PHP Database Reader
About the PHP Database Reader

The PHP database reader allows your PHP application to use the on-premise IPQS email verification database and make informed decisions about email addresses.

Installation

Install via Composer

You can easily install the PHP database reader using composer:

composer require ipqualityscore/ipqs-php-email-db-reader  

Usage

The following example shows how you can use the PHP database reader in your application to retrieve data about a specific email address:

Functions

Some of these functions may be unavailable depending on which database file you receive. If the function in question is unavailable in your database, it will default to null.

******FILL OUT TABLE******

Function Type Description
$record->Base()->Valid bool Does this email address appear valid?
$record->Base()->Disposable bool Is this email suspected of belonging to a temporary or disposable mail service? Usually associated with fraudsters and scammers.
$record->Base()->SmtpScore int Validity score of email server's SMTP setup. Range: "0" to "3".

0x00 = mail server exists, but is rejecting all mail
0x01 = mail server exists, but is showing a temporary error
0x02 = mail server exists, but accepts all email
0x03 = mail server exists and has verified the email address
$record->Base()->Suspect bool This value indicates if the mail server is currently replying with a temporary mail server error or if the email verification system is unable to verify the email address due to a broken SMTP handshake. This status will also be true for "catch all" email addresses as defined below. If this value is true, then we suspect the "valid" result may be tainted and there is not a guarantee that the email address is truly valid. This status is rarely true for popular mailbox providers and typically only returns as true for a small percentage of business mail servers.
$record->Base()->CatchAll bool Is this email likely to be a "catch all" where the mail server verifies all emails tested against it as valid? It is difficult to determine if the address is truly valid in these scenarios, since the email's server will not confirm the account's status.
$record->Base()->Deliverability int How likely is this email to be delivered to the user and land in their mailbox. Values can be "high", "medium", "low" or "none".

0x00 = none
0x01 = low
0x02 = medium
0x03 = high
$record->FraudScore()->FraudScore int The overall Fraud Score of the user based on the email's verification and recent behavior across the IPQS threat network. Fraud Scores >= 75 are suspicious, but not necessarily fraudulent.
$record->Leaked()->Leaked bool Was this email address associated with a recent database leak from a third party? Leaked accounts pose a risk as they may have become compromised during a database breach.
$record->RecentAbuse()->RecentAbuse bool This value will indicate if there has been any recently verified abuse across our network for this email address. Abuse could be a confirmed chargeback, fake signup, compromised device, fake app install, or similar malicious behavior within the past few days.
$record->UserVelocity()->UserVelocity bool Frequency at which this email address makes legitimate purchases, account registrations, and engages in legitimate user behavior online. Values can be "high", "medium", "low", or "none". Values of "high" or "medium" are strong signals of healthy usage. New email addresses without a history of legitimate behavior will have a value as "none". This field is restricted to higher plan tiers.
$record->DomainCommon()->DomainCommon bool Is this email from common free email providers? ("gmail.com", "yahoo.com", "hotmail.com", etc.)
$record->DomainVelocity()->DomainVelocity bool Indicates the level of legitimate users interacting with the email address domain. Values can be "high", "medium", "low", or "none". Domains like "IBM.com", "Microsoft.com", "Gmail.com", etc. will have "high" scores as this value represents popular domains. New domains or domains that are not frequently visited by legitimate users will have a value as "none". This field is restricted to upgraded plans.
$record->DomainDisposable()->DomainDisposable bool Is this domain suspected of belonging to a temporary or disposable mail service? Usually associated with fraudsters and scammers.

Ready to eliminate fraud?

Start fighting fraud now with 5,000 Free Lookups!

We're happy to answer any questions or concerns.

Chat with our fraud detection experts any day of the week.

Call us at: (800) 713-2618