Telesign Integration
Phone Validation
PRICING
Your account will be charged $0.10 for each append by this service.
VERSION
1.3.0
ADDITIONAL INFO
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 Field | Description |
|---|---|
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.
| Field | Description |
|---|---|
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).
| Variable | Description |
|---|---|
| Timeout Seconds | Produce an "error" outcome if the server fails to respond within this number of seconds (default: 360) |
