/score/{complete_phone_number}
The Score API is a REST API that delivers reputation scoring based on phone number intelligence, traffic patterns, machine learning, and a global data consortium. NOTE: If you try this API out using the API Explorer, you will be billed for the transaction as you normally would.
All requests submitted for the Score API:
- Can be authenticated with Basic (easiest to implement) and Digest
- Use
https://rest-api.telesign.com/v1/score/<complete_phone_number>
as the endpoint. The complete phone number includes the country code and has no special characters or spaces. - Accept only UTF-8 encoded unicode characters as inputs.
- Use Content-Type application/x-www-form-urlencoded in request headers.
Request Parameters
Request Body
Responses
Your request was fulfilled and resulted in a new resource being created. If you want to code against a response, you should retrieve the status or error code and use that rather than the HTTP status response.
Status Code | Associated Text String | Description |
---|---|---|
300 | Transaction successfully completed | The system was able to obtain all of the requested data for PhoneID. |
301 | Transaction partially completed | The system was able to obtain some of the data for PhoneID, but not all of it. |
A 32-digit hex value used to identify the web service request. The value is unique to each web service request, is randomly-generated by TeleSign, and is returned in the response message immediately following the web service request.
An object containing details about the request status.
An object containing details about the numbering attributes of the specified phone number.
An object containing information about the company that provides telecommunications servoces for the phone number.
An object that describes the risk score for the phone number specified in the request