Telesign Integration
Phone Validation
PRICING
Your account will be charged $0.1 for each append by this service.
VERSION
1.5.3
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 | The outcome primarily indicates whether the number is Active or Disconnected. Failure can be for either a disconnected line or a disallowed phone type e.g. payphone, pager, etc. |
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 |
|---|---|
| Allow Non Us | Set to "true" to allow non-US numbers. Assumes all numbers start with country code, defaults to "false". |
| Timeout Seconds | Produce an "error" outcome if the server fails to respond within this number of seconds (default: 360) |