Intelligence - Get started

Use Telesign Intelligence to get a risk score and related insights. You can either feed this data into your risk model or decide whether to proceed based on a risk score threshold.

General Requirements

  • Authentication: Basic (use Intelligence Customer ID and API Key)
  • Protocols: HTTPS
  • Endpoint: https://detect.telesign.com/intelligence
  • Encoding: Accepts only UTF-8 unicode characters as inputs.
  • Accepts: application/json
  • Responds With: application/json
  • Required Headers: Content-Type - application/json

🚧

CAUTION:

Requests to this endpoint authenticate using a different Customer ID and API Key than other Telesign services. If you don't know your Intelligence authentication credentials, reach out to our Customer Support Team.

Basic usage

  1. A user inputs contact data and initiates an action on your site.
  2. Your application takes their contact data and any other identity data you have for them (such as IP address) and includes it in a POST /intelligence request.
  3. The service responds with a risk score and reason codes. These can be used to power your verification risk model or you can make a decision based directly on the score. See Decision matrix below.
  4. If you are satisfied with the evaluation of the user, you can allow the action to proceed on your site.

Decision matrix

Although this service returns Telesign's overall assessment of the risk of a user, you make the final decision about whether to proceed. We recommend creating a decision matrix like the one below, to determine how your integration will process user attempts.

Example decision matrix

Telesign scoreTelesign risk levelYour decision
0-200very lowallow
201-400lowallow
401-600mediumflag
601-800highblock
801-1000very highblock

Learn more with reason codes

To understand the details of why Telesign gave the score that it did, look up the reason codes returned on Score API - Insights reason code mappings.

Actions

  • POST /intelligence
    Use this action to evaluate the specified end user, requesting a risk score and related insights.

Did this page help you?