Telesign Integration

Phone Validation

PRICING

Your account will be charged $0.10 for each append by this service.

VERSION

1.2.5

ADDITIONAL INFO

Telesign Website

Overview

Verify a phone number has an active subscriber in real-time, as well as subscriber status, line type, and registration location information.

Appended Fields

Telesign will append the following data to your lead.

Appended FieldDescription
Outcome
Integration outcome (success, failure, or error)
Reason
If outcome is error, the error reason
Risk
Risk rating for a given number. Either 'low', 'medium-low', 'medium-high', 'high', or 'unknown'
Phone Type
The phone type. Either 'fixed', 'mobile', 'prepaid', 'tollfree', 'voip', 'pager', 'payphone', 'invalid', 'restricted', 'personal', 'voicemail', or 'other'
Subscriber Status
The current status of the subscriber’s phone number. Either 'active' or 'disconnected'
Device Status
The current status of the phone equipment. Either 'reachable', 'unavailable', or 'unreachable'
Carrier
A string specifying the name of the carrier.
Roaming
Whether or not the mobile device is currently roaming outside of the coverage area. Either 'yes', 'no', or 'unavailable'
Roaming Country Code
The ISO 3166-1 2-letter Country Code in which the mobile device is roaming.
Location City
A string specifying the name of the city associated with the phone number.
Location State
The 2-letter State Code of the state (province, district, or territory) associated with the phone number (North America only).
Location Postal Code
The 5-digit United States Postal Service ZIP Code associated with the phone number (U.S. only).
Location Metro Code
A 4-digit string indicating the Primary Metropolitan Statistical Area (PMSA) Code for the location associated with the phone number (U.S. only). PMSA Codes are governed by the US Census Bureau.
Location County
A string specifying the name of the County (or Parish) associated with the phone number (U.S. only).
Location Country Code
The ISO 3166-1 2-letter Country Code associated with phone number.
Location Latitude
A value indicating the number of degrees of latitude of the location associated with the phone number, expressed in seven decimal digits, with five decimal places.
Location Longitude
A value indicating the number of degrees of longitude of the location associated with the phone number, expressed in eight decimal digits, with five decimal places.
Location Time Zone
A string identifying the Time Zone Name (TZ) associated with the phone number (U.S. only).
Errors
An array of property-value pairs containing information about errors that might have resulted from the request.
Partial
If only partial data was returned
Billable
If the event is billable, billable count else 0

Fields

The following fields are used by this integration and automatically added to your flow when missing.

FieldDescription
Phone 1
Required fieldTelesign needs this data to function.
Phone number

Custom Input Variables

The following are configuration options (typically not collected with lead data).

VariableDescription
Timeout SecondsProduce an "error" outcome if the server fails to respond within this number of seconds (default: 360)