IPQS
Getting Started
About the Phone Number Validation API

The IPQS Phone Number Validation API offers rapid analysis to determine the risk core, country of origin, carrier, validity, owner information, and connection status of phone numbers. By using this API, you can authenticate users, improve chargeback defense, and detect fraudulent activities in real-time. It can investigate landline and cellular numbers in over 150 countries, identifying invalid numbers and potential fraudsters.

Perform carrier lookups by API in any region to detect disconnected phone numbers and retrieve important carrier info, including line types, to determine if a number is a VOIP, landline, mobile/wireless, or prepaid line. Cell phone lookups typically have better identity enrichment hit rates. Reverse phone number lookups can also provide a personal or company name associated with a phone number to help validate identity and prevent abusive behavior.

Test IPQS phone number reputation data with our free phone number validator, which can also retrieve spam scores and risk scores. Phone number validation is available through real-time, on-demand phone validation API lookups, with full coverage for international phone numbers.

Accurately verify phone numbers worldwide and retrieve a combination of carrier and line type details with risk analysis data to assess the reputation of phone numbers. Our system collects phone validation and verification data from various telecom carriers, with support in over 150 countries for international phone number validation. Detect inactive and disconnected phone numbers for easy user validation similar to HLR & LRN lookups. Identify if the line is active, the phone is turned off, or the subscriber is absent or disconnected. Customizable settings allow you to tailor scoring to your audience. 

 

Reverse Phone Number Lookup API

Lookup the owner of the phone number including first and last name or the company's name with real-time API responses. Reverse phone lookups have excellent coverage in the US and Canada and limited support internationally, including Europe and Asia. Reverse name lookups for phone numbers can help verify identity, limit abusive behavior, prevent unwanted callers, and enrich lead and contact details directly through our reverse phone lookup API.

 

Phone Number Carrier and Line Type Detection API

Look up carrier details and phone number line types, such as landline, VOIP, wireless, and prepaid, with precision and accuracy worldwide. IPQS maintains current data directly from carriers on a global level. Riskier carriers and phone ranges associated with malicious behavior will display elevated Fraud Scores to enable your business logic to identify threats effectively.

 

Proxy Detection API Use Cases

  • Reverse Phone Number Lookup: Search for the owner's name with worldwide coverage rates using reverse phone lookups. Easily verify user identity to limit bad actors.

  • Phone Number Fraud Prevention: Phone Number Risk Scoring prevents abusive behavior from fraudulent users and high-risk accounts. Prevent fraud and abuse simply by checking the phone number against our global blocklists.

  • Low-Quality Users: Identify duplicate user accounts, stolen user data, and fake registrations. Automatically block low-quality accounts.

  • Chargebacks & Payment Fraud: Mitigate chargebacks, high-risk transactions, and all types of e-commerce fraud by detecting phone numbers associated with recent malicious behavior.

  • Instant Validation: Identify disconnected or inactive phone numbers to quickly validate user data to screen applications, registrations, and payments.

  • Bot Detection: Filter nonexistent and invalid phone numbers to stop bots, risky users, and bad leads.

  • Geo Filtering: Filter users by validating their phone number matches their location. Pair with IP Reputation scoring for comprehensive geo-filtering.

  • High-Risk Behavior: Analyze user phone numbers to prevent fraudulent numbers by detecting disposable SMS, temporary phone numbers, Google Voice, and VOIPs.

  • Lead Generation & User Data Verification: Validate phone numbers to ensure the data you collect is valid, accurate, and fresh to prevent fake leads.
API Request URLs

You can use the following URLs to submit phone numbers to the Phone Number Verification API. Replace USER_PHONE_HERE with the phone number to validate.

 

Note: If the supplied phone number is less than 10 digits and does not have any possible countries included in the API request, then the API will like return the number as invalid. For best results, please ensure phone numbers are at least 10 digits long or supply at least one valid country.

 

 

JSON

 

XML

 

 

Example API Requests

API Lookup with US, CA, and UK countries supplied
Countries supplied to our API will be preferred for our verification process and will be used in the event a short phone number is supplied to the API.  

 

 

API Lookup with Strictness Set to 1
If a phone number is invalid or fraudulent, a higher strictness will increase the verification requirements and potentially increase the fraud score or other factors.  

Example API Responses

Success Responses

This is an example success response in JSON format. Details about each of these variables can be found in Response Parameters.

 

This is an example success response in XML format. Details about each of these variables can be found in Response Parameters.

 

Error Responses

Example errors that you may encounter when accessing our API due to an exhausted credit balance or an invalid phone number.

 

Next Steps

Tailor your API requests to match your specific needs with additional request parameters and other advanced options. Or learn more about each of the variables included in the responses you receive.

EXAMPLE CODE

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