Incode’s Advanced Phone Risk Check determines the level of risk associated with a phone number. The Phone Risk Check module can be added to your workflow to evaluate the trust and potential risk of a phone number based on intelligence signals.

Integration

User input flow

Advanced Phone Risk Check module configuration allows collection of user data via a user input flow where users can select the country code and type in their phone number. See an example below:

Module configuration

The module configuration can be leveraged to select the applicable fields for the input data you would like to collect from the end user.

Direct API Approach

All module configurations and user data can be forwarded directly in the request for performing an eKYC search. This will override existing configuration and data collected about the user.

📘
API Authentication
All endpoints require authentication headers to be specified as stated in Incode API Documentation

eKYC request

POST /omni/externalVerification/ekyc

This endpoint performs an eKYC check for the individual specified. Note: Endpoint can have empty body {} and in that case information will be pulled from module configuration and session details.

phone: (mandatory) String.
country: (mandatory) String. Must be "GL".
source: (mandatory) String. Must be "PHONE_RISK_2"

Example request:

{
  "countryCode": "GL",
  "phone": "+12506503121",
   "plugins": 
  [
      "kyc"
  ],
  "source": "PHONE_RISK_2"
}

Direct API Response

📘
API Authentication
All endpoints require authentication headers to be specified as stated in Incode API Documentation

Note: Endpoint can have empty body {} and in that case information will be pulled from module configuration and session details.

{
  "confidenceLevel": "high",
  "firstSeen": "2018-10-16",
  "connectedPlatforms": "facebook, whatsapp, apple, snapchat, viber, google,amazon",
  "previousCarrier": "Carrier ABC",
  "phoneValid": "true",
  "lastPorted": "2024-09-25",
  "phoneActive": "true",
  "activityScore": "902",
  "totalBreaches": "2",
  "digitalPresenceScore": "very strong",
  "checkStatus": "found",
  "phonePorted": "false",
  "isDisposable": "false",
  "multipleBreachExposure": "true",
  "phoneLineType": "mobile",
  "vendorRiskLevel": "low",
  "overallLevel": "Low",
  "currentCarrier": "TCarrier XYZ",
   "activityDescription": "Phone number is reachable with consistent network activity and all conditions met",
   "phoneName": "John Doe",
   "footprintScore": "902",
   "firstBreachDate": "2017-12-22",
   "lastBreachDate": "2024-09-25"
}

eKYC error responses

Please refer to error response to see conventional HTTP response codes to indicate the success or failure of an API request.

For email, custom 400 error messages if country is “ “ or null:

Incode API Key	Status	Definition
checkStatus	String	Outcome of the check for the provided phone number.
phoneLineType	String	Type of line (e.g., mobile, landline).
phoneValid	true, false	Indicates whether the phone number is valid.
phonePorted	true, false	Indicates whether the phone number is ported.
currentCarrier	String	Name of the current carrier/service provider
previousCarrier	String	Name of the current carrier/service provider
lastPorted	Date	Date when the number was last ported in YYYY-MM-DD format. Only exists in response if the number has been ported.
phoneActive	true, false	Indicates whether this phone number is a live, usable phone number that is currently active.
activityScore	Integer	Activity score ranging from 0-1000 represents the quality of the phone number. Higher score indicates better activity and confidence.
activityDescription	String	Indicates how much network activity and information is available to determine if the phone number is reachable.
footprintScore	Integer	Digital footprint score ranging from 0-1000 represents the quality of the phone number. Higher score indicates better activity and confidence.
overallLevel	Low, Medium, High, Very High	Represents the level of risk associated with the phone number.
isDisposable	true, false	Indicates whether this phone number is of disposable type.
totalBreaches	String	Indicates the number of breaches the phone number was found in.
firstBreachDate	Date	Date the number was first found in a data breach
lastBreachDate	Date	Date the number was found most recently in a data breach
multipleBreachExposure	true, false	Indicates whether the phone number was found in multiple breaches.
connectedPlatforms	String	List of social media platforms where an account is associated with this phone number.
digitalPresenceScore	Integer
phoneName	String	Name of the person associated with this phone number
confidenceLevel	Low, Medium, High, Very High
firstSeen	Date	Date when this phone number was first seen in our data partner’s network.

Integration

User input flow

Module configuration

Direct API Approach

API Authentication

eKYC request

Direct API Response

API Authentication

Single Session Dashboard Result