Phone Reputation API Documentation


IPQS risk analysis tools enable Phone Reputation scoring through an API call. 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 in abusive behavior. Phone Reputation screening is a great way to automatically prevent fake accounts and fraudulent behavior.

Phone Reputation API

Phone numbers are 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.

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 IPQS? View our base Proxy Detection API Documentation to get started..

API Lookup with Billing Phone Number
The user's primary information can be passed into the "billing" variables even if a transaction is not taking place. Additional user data can be passed with this request.


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.)
shipping_country String (optional) User shipping or secondary country name or shipping country ISO-Alpha2. (EG: United States or US)
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.)
Example Code