Your account will be charged $0.1 for each append by this service.
Verify a phone number has an active subscriber in real-time, as well as subscriber status, line type, and registration location information.
Telesign will append the following data to your lead.
|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.|
|If outcome is error, the error reason|
|Risk rating for a given number. Either low, medium-low, medium-high, high, or unknown|
|The phone type. Either fixed, mobile, prepaid, tollfree, voip, pager, payphone, invalid, restricted, personal, voicemail, or other|
|The current status of the subscriber’s phone number. Either active or disconnected|
|The current status of the phone equipment. Either reachable, unavailable, or unreachable|
|A string specifying the name of the carrier.|
|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.|
|A string specifying the name of the city associated with the phone number.|
|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.|
|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.|
|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.|
|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).|
|An array of property-value pairs containing information about errors that might have resulted from the request.|
|If only partial data was returned|
|If the event is billable, billable count else 0|
The following fields are used by this integration and automatically added to your flow when missing.
Required fieldTelesign needs this data to function.
Custom Input Variables
The following are configuration options (typically not collected with lead data).
|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)|