Preferences

Phone number

Configure the variable that contains the phone number that will be analyzed.

Usually, the variable "source_phone" from the Incoming Call is used as the input variable, but any other variable that contains a phone number can be used.

If the variable containing the phone number is not the "source_phone", the call attestation information will not be available.

Variables

There are two sets of variables that can be used to route the call in Studio, and these can be seen in the table below. Use them to fill in the relevant "Variables" fields.

Phone validation insights.
SHAKEN/STIR call attestation.

Validation Insights

Validation Insight	Description	Value type	Value ranges
VOIP	Illustrates whether this phone number is a Voice Over Internet Protocol (VOIP) or a digital phone number.	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"*
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"
Active	Reveals if this phone number is a live phone number that is currently active.	String	"true" "false" "N/A"
Leaked	Indicates whether this phone number has recently been exposed in an online database breach or compromise.	Boolean	"true" "false"
Status	The phone validation status as a result of the Fraud Score.	String	"SAFE" "SUSPICIOUS" "HIGH_RISK"
Carrier	The carrier this phone number has been assigned to, or "N/A" if unknown.	String	(the carrier name) null
Country	Indicates the 2-character country code associated with this phone number	String	"US" "PT" "GB"
Spammer	Identifies if the phone number has recently been reported for spam or harassing calls/texts	Boolean	"true" "false"
Pre Paid	Indicates if this phone number is associated with a prepaid service plan.	String	"true" "false" "N/A"
Line Type	The type of line this phone number is associated with (Toll-Free, Wireless, Landline, Satellite, VOIP, Premium Rate, Pager, etc...) or "N/A" if unknown.	String	"VOIP" "Toll-Free" "Wireless" "Landline" "Satellite" "Premium Rate" "Pager" "N/A"
Do Not Call	Indicates if the phone number is listed on any Do Not Call (DNC) list. Only supported in the US and CA.	String	"true" "false" "N/A"
Fraud Score	The risk score. It 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
Recent Abuse	Details whether this phone number has been associated with recent or ongoing fraud.	String	"true" "false" "N/A"
Validations (last 24h)	Counts how many times Phone Validation was triggered for this number in the past 24 hours. Particularly useful for detecting fraud risk when there is an unusual number of interactions.	Integer	"15"
Name	Owner's name linked to the phone number via reverse lookup. Helps confirm a user is who they claim to be. Coverage is strongest in the US and Canada.	String	Free-text name, or "" / N/A if no match found
City	City associated with the phone number's registered location. Useful for cross-checking against user-supplied location data or billing address.	String	City name string, or "" if unavailable
Region	State or region tied to the phone number's registered location. Supports geo-filtering and consistency checks against other user-provided data.	String	Region / state name string, or "" if unavailable
Zip-code	Postal code associated with the phone number's registered location. Enables precise address validation and fraud geo-filtering.	String	Postal code string (format varies by country), or "" if unavailable
Timezone	IANA timezone derived from the phone number's registered location. Can be used to detect mismatches between the device timezone and the number's origin.	String	IANA tz string (e.g. America/Los_Angeles), or "" if unavailable
Do not call	Indicates whether the number appears on a Do Not Call registry. Critical for outbound calling and SMS compliance to avoid regulatory penalties.	Boolean	true — on DNC list false — not on DNC list
TCPA blacklist	Flag numbers blacklisted under TCPA (US Telephone Consumer Protection Act). Contacting blacklisted numbers can expose the business to significant legal liability.	Boolean	true — TCPA blacklisted false — not blacklisted

SHAKEN/STIR Call Attestation

Call attestation	Spoofing detection	Description
TN-Validation-Passed-A	Safe	The service provider has fully authenticated that the customer initiating the call is authorized to use the calling number.
TN-Validation-Failed-A	Save (Unable to verify)	The service provider has fully authenticated that the customer initiating the call is authorized to use the calling number. Although the call was attested with a particular status, the final carrier could not confirm that the attestation was the one presented.
TN-Validation-Passed-B	Suspicious	The carrier can authenticate its relationship with the calling customers but cannot verify if the consumer is authorized to use the number
TN-Validation-Failed-B	Suspicious (Unable to verify)	The carrier can authenticate its relationship with the calling customers but cannot verify if the consumer is authorized to use the number. Although the call was attested with a particular status, the final carrier could not confirm that the attestation was the one presented.
TN-Validation-Passed-C	High risk	The initiating service provider has authenticated that it placed the call on its network but has no relationship with the caller.
TN-Validation-Failed-C	High risk (Unable to verify)	The initiating service provider has authenticated that it placed the call on its network but has no relationship with the caller. Although the call was attested with a particular status, the final carrier could not confirm that the attestation was the one presented.
No-TN-Validation	N/A	The carrier is unable to verify the caller for this phone number country or region.
TN-Validation-Failed	N/A	The carrier is unable to verify the caller for this phone number country or region.