Phone Validation API

Overview

The Phone Validation API, a Talkdesk Identity™ solution, performs a series of phone validations in inbound calls to get device and phone number fraud-related insights.

📘
Use Case
As a real life example, consider the scenario where Talkdesk administrators want to get insights regarding a designated phone number, or even a series of phone numbers. Using the Phone Validation API, it is possible to get insights into the phone number(s) so those can be used to integrate with third-party systems.

👍
Access and Registration
Authentication

Usage

Getting the phone number insights (this endpoint helps understand the variables below).

Variable	Description	Value Type	Value Ranges
Active	Reveals if this phone number is a live phone number that is currently active	String	- True - False - N/A
Carrier	The carrier this phone number has been assigned to, or "N/A" if unknown	String	- - Null
Country	The two-character country code for the phone number	String	Example: “PT”, “US”
Do Not Call (DNC)	Indicates if the phone number is listed on any DNC lists	String	- True - False - N/A
Fraud Score	The risk score, which measures how likely a phone number is to be fraudulent	Integer	Percentage from 0 to 100 with no decimal numbers: - Fraud scores < 75% are considered Safe. - Fraud scores >= 75% and < 85% are Suspicious. - Fraud scores >=85% are High-risk.
Leaked	Indicates if this phone number has recently been exposed in an online database breach or act of compromise	String	- True - False - N/A
Line Type	The type of line this phone number is associated with (Toll-Free, Wireless, Landline, Satellite, Voice Over Internet Protocol - VOIP, Premium Rate, Pager, etc.), or "N/A" if unknown	String	- VOIP - Toll-Free - Wireless - Landline - Satellite - Premium Rate - Pager - N/A
Prepaid	Indicates if this phone number is associated with a prepaid service plan	String	- True - False - N/A
Risky	Points out if this phone number is associated with fraudulent activity, scams, fake accounts, or other suspicious behavior	String	- True - False - N/A
Spammer	Indicates if the phone number has recently been reported for spam or harassing calls/texts	String	- True - False - N/A
Status	The phone validation status as a result of the Fraud Score	String	- True - False - N/A
Recent Abuse	Details on whether this phone number has been associated with recent or ongoing fraud	String	- True - False - N/A
Region	The region (state) of the phone number if available, or "N/A" if unknown	String	Example: “CA”, “AZ”
Valid	Indicates if the phone number is considered valid based on assigned phone numbers available to carriers in the caller’s country	Boolean	- True - False
VOIP	Illustrates if this phone number is a VOIP or a digital phone number.	String	- True - False - N/A
When	The date and time when the call took place	String	yyyy-mm-ddThh:mm:ss.s

📘
Supported Regions and Base URLs

👍
API Availability
The Phone Validation API has been in General Availability since February 2022.

Troubleshooting

If you have questions or technical issues, please open a ticket using this form.