Phone Reputation API Documentation

Phone Number Validation and Carrier Lookup API

IPQualityScore risk analysis tools enable user scoring with the IPQualityScore Phone Validation API service using a straight forward API call with worldwide carrier support. Generate a phone number reputation score to verify users, payments, & sign ups to prevent fraudulent behavior. Detect VOIP numbers with a phone number risk score to prevent suspicious users.

Identify low quality users and fraudulent phone numbers in real-time. Detect temporary or disposable phone numbers as well as phone numbers that have recently been involved with abusive behavior online. Phone Reputation screening is a great way to automatically prevent fake accounts and fraudulent behavior.

Please note, if you wish to verify phone numbers without passing an IP address, please use our dedicated phone number validation API. Test our phone validation service anytime with our free phone number validator tool.

Phone Number Reputation API

Phone numbers are validated and analyzed for fraudulent activity by verifying the phone number exists with the carrier, without an SMS message or phone call. Forensic scoring and checks against our high risk user database, powered by Fraud Fusion™, are performed to determine if the phone number has been associated with confirmed reports of fraudulent behavior. Risk analysis for phone numbers will be returned in the "transaction_details" object.

Phone Validation

Each phone number is validated to verify the correct syntax and country code. If a country code is not provided, our system can automatically detect the country code based on the IP address or similar user data. All phone numbers are validated against the local carriers in each country. This service supports phone validation for any country or region including cellular, VOIP, and land lines.

Phone Number Fraud Prevention & Risk Scoring

Verify users, payments, and applications with accurate phone number fraud prevention, combining advanced phone number risk scoring with deep phone reputation checks. Match names to phone numbers detect risky virtual numbers like VOIPs, disposable phone numbers, and similar high risk behavior signals. The IPQualityScore phone number reputation API can also identify mobile and landline numbers that have been recently associated with bad actors and abuse.

VOIP & Disposable Phone Number Detection

Detect a wide range of suspicious phone numbers such as digital voice and VOIP lines. Accurately prevent robo callers and temporary or disposable phone numbers often used to bypass OTP (one time password) verification methods. IPQualityScore supports worldwide coverage for high risk disposable numbers.

Phone Carrier Detection API

Retrieve the phone carrier and line type with each lookup request. Examples of the carrier include "AT&T", "Verizon", "Vodafone", "T-Mobile", etc. The telephone line type will be classified as Landline, Wireless, Toll Free, VOIP, Satellite, Premium Rate, Pager, Internet Service Provider or Unknown.

Country Dial Codes

If the country dial-in code is known, then please supply it with the billing or shipping phone and include "+" symbol at the start of the number. This ensures our system can accurately verify the phone number. If the country code is unknown or the user's input is unvalidated, please pass the billing or shipping number without a "+" symbol. Our algorithms will attempt to detect the country code based on the IP address and billing/shipping country variables.

Scoring Additional User Information

Additional user data such as physical addresses, email addresses, full names, devices, and IP addresses, can also be scored for risk analysis. Please view the Transaction Scoring documentation to learn more.

JSON Phone Reputation Example API Request

The example below incorporates scoring a phone number with an IP address. Phone numbers without a valid country code will assume the country code of the request's IP address. New to IPQualityScore? View our base Proxy Detection API Documentation to get started..

API Inputs

Key	Expected Values	Description
billing_country	String (optional)	User billing or primary country name or billing country ISO-Alpha2. (EG: United States or US)
billing_phone	Number	User billing or primary 11 to 14 digit phone number. (If less than 10 digits provided, the country code will be guessed by our AI.)
billing_phone_country_code	Number (optional)	Country dialing code associated with the billing phone. Typically 1-3 digits.
shipping_country	String (optional)	User shipping or secondary country name or shipping country ISO-Alpha2. (EG: United States or US)
shipping_phone_country_code	Number (optional)	Country dialing code associated with the shipping phone. Typically 1-3 digits.
shipping_phone	Number (optional)	User shipping or secondary 11 to 14 digit phone number. (If less than 10 digits provided, the country code will be guessed by our AI.)

Phone Validation API Response Fields

The following phone validation data points are returned as the API response.

Key	Expected Values	Description
risky_billing_phone	Boolean	Reputation analysis for abusive activity associated with the phone number.
risky_shipping_phone	Boolean	Same as above.
valid_billing_phone	Boolean	Valid & active phone number with the phone carrier (not disconnected).
valid_shipping_phone	Boolean	Same as above.
billing_phone_carrier	String	Phone number provider company such as "AT&T" or "Bell Canada".
shipping_phone_carrier	String	Same as above.
billing_phone_line_type	String	Landline, Wireless, Toll Free, VOIP, Satellite, Premium Rate, Pager, Internet Service Provider or Unknown.
shipping_phone_line_type	String	Same as above.
billing_phone_country	String	2-letter country code associated with the phone number.
shipping_phone_country	String	Same as above.
billing_phone_country_code	Integer	Country dialing code associated with the phone number.
shipping_phone_country_code	Integer	Same as above.