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	<the carrier name> 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.