RapidAPI logo

TeleSign Score

FREEMIUM
By telesignOfficial
Updated 5 months ago
Communication
2.6/10
Popularity Score
160ms
Latency
80%
Success Rate

TeleSign Score API Documentation

Delivers reputation scoring based on phone number intelligence, traffic patterns, machine learning and a global data consortium

View API Details
POSTScore
POSTScore

Send a request that a phone number be evaluated to see whether it is potentially used for fraudulent activities.

Header Parameters
X-RapidAPI-HostSTRING
REQUIRED
X-RapidAPI-KeySTRING
REQUIRED
Required Parameters
account_lifecycle_eventSTRING
REQUIREDThe account lifecycle event parameter allows you to send information about what stage an end user was in when you retrieved information about their phone number. Acceptable values for this parameter are - create - For the creation of a new account. sign-in - For when an end user signs in to their account. transact - For when an end user completes a transaction within their account. update - For when an update is performed, such as an update of account information or similar. delete - For when an account is deleted.
complete_phone_numberSTRING
REQUIREDThe phone number you want to collect information about. Provide the entire phone number with no spaces or special characters.
Optional Parameters
account_idSTRING
OPTIONALYour end user’s account ID. This value is case sensitive, a string, must be created with Unicode characters, and encoded as UTF-8.
device_idSTRING
OPTIONALYour end user’s device ID. This value is case sensitive, a string, must be greated with Unicode characters, and encoded as UTF-8.
email_addressSTRING
OPTIONALYour end user’s email address. This value is case sensitive, a string, must be created with Unicode characters, and encoded as UTF-8.
originating_ipSTRING
OPTIONALYour end user’s IP address (do not send your own Ip address). IPv4 and IPv6 are supported. For IPv4, the value must be in the format defined by the Internet Engineering Task Force (IETF) in the Internet-Draft doucment titled Internet Protocol. For IPv6, the value must be in the format defined by the IETF in the Internet-Draft document titled IP Version 6 Addressing Arcitecture.
Code Snippet
unirest.post("https://telesign-telesign-score-v1.p.rapidapi.com/score/{complete_phone_number}")
.header("X-RapidAPI-Host", "telesign-telesign-score-v1.p.rapidapi.com")
.header("X-RapidAPI-Key", "SIGN-UP-FOR-KEY")
.header("Content-Type", "application/x-www-form-urlencoded")
.send("account_lifecycle_event=<required>")
.end(function (result) {
  console.log(result.status, result.headers, result.body);
});
Sample Response
General
Request URL: https://telesign-telesign-score-v1.p.rapidapi.com/score/{complete_phone_number}
Request Method: POST
Response Headers
Response Body

Install SDK for NodeJS

Installing

To utilize unirest for node.js install the the npm module:

$ npm install unirest

After installing the npm package you can now start simplifying requests like so:

var unirest = require('unirest');

Creating Request

unirest.post("https://telesign-telesign-score-v1.p.rapidapi.com/score/{complete_phone_number}")
.header("X-RapidAPI-Host", "telesign-telesign-score-v1.p.rapidapi.com")
.header("X-RapidAPI-Key", "SIGN-UP-FOR-KEY")
.header("Content-Type", "application/x-www-form-urlencoded")
.send("account_lifecycle_event=<required>")
.end(function (result) {
  console.log(result.status, result.headers, result.body);
});
OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication