class TelesignEnterprise::PhoneIdClient

A set of APIs that deliver deep phone number data attributes that help optimize the end user verification process and evaluate risk.

TeleSign PhoneID provides a wide range of risk assessment indicators on the number to help confirm user identity, delivering real-time decision making throughout the number lifecycle and ensuring only legitimate users are creating accounts and accessing your applications.

Public Class Methods

new(customer_id, api_key, rest_endpoint: 'https://rest-ww.telesign.com', timeout: nil) click to toggle source
Calls superclass method
# File lib/telesignenterprise/phoneid.rb, line 19
def initialize(customer_id,
               api_key,
               rest_endpoint: 'https://rest-ww.telesign.com',
               timeout: nil)

  super(customer_id,
        api_key,
        rest_endpoint: rest_endpoint,
        timeout: timeout)
end

Public Instance Methods

contact(phone_number, ucid, **params) click to toggle source

The PhoneID Contact API delivers contact information related to the subscriber's phone number to provide another set of indicators for established risk engines.

See developer.telesign.com/docs/rest_api-phoneid-contact for detailed API documentation.

# File lib/telesignenterprise/phoneid.rb, line 55
def contact(phone_number, ucid, **params)

  self.get(PHONEID_CONTACT_RESOURCE % {:phone_number => phone_number},
           ucid: ucid,
           **params)
end
live(phone_number, ucid, **params) click to toggle source

The PhoneID Live API delivers insights such as whether a phone is active or disconnected, a device is reachable or unreachable and its roaming status.

See developer.telesign.com/docs/rest_api-phoneid-live for detailed API documentation.

# File lib/telesignenterprise/phoneid.rb, line 66
def live(phone_number, ucid, **params)

  self.get(PHONEID_LIVE_RESOURCE % {:phone_number => phone_number},
           ucid: ucid,
           **params)
end
number_deactivation(phone_number, ucid, **params) click to toggle source

The PhoneID Number Deactivation API determines whether a phone number has been deactivated and when, based on carriers' phone number data and TeleSign's proprietary analysis.

See developer.telesign.com/docs/rest_api-phoneid-number-deactivation for detailed API documentation.

# File lib/telesignenterprise/phoneid.rb, line 77
def number_deactivation(phone_number, ucid, **params)

  self.get(PHONEID_NUMBER_DEACTIVATION_RESOURCE % {:phone_number => phone_number},
           ucid: ucid,
           **params)
end
score(phone_number, ucid, **params) click to toggle source

Score is an API that delivers reputation scoring based on phone number intelligence, traffic patterns, machine learning, and a global data consortium.

See developer.telesign.com/docs/rest_api-phoneid-score for detailed API documentation.

# File lib/telesignenterprise/phoneid.rb, line 44
def score(phone_number, ucid, **params)

  self.get(PHONEID_SCORE_RESOURCE % {:phone_number => phone_number},
           ucid: ucid,
           **params)
end
standard(phone_number, **params) click to toggle source

The PhoneID Standard API that provides phone type and telecom carrier information to identify which phone numbers can receive SMS messages and/or a potential fraud risk.

See developer.telesign.com/docs/rest_phoneid-standard for detailed API documentation.

# File lib/telesignenterprise/phoneid.rb, line 34
def standard(phone_number, **params)

  self.get(PHONEID_STANDARD_RESOURCE % {:phone_number => phone_number},
           **params)
end