Insights Overview

№	Name	API Code	API tag	Required Module
1	Device	`deviceInfo`	`features`	Core Module
2	Velocity	`velocity`	`features`	Core Module
3	IP Info	`ipInfo`	`features`	Core Module
4	Apps Tracking	`application`	`features`	Application Module
5	Fraud Alerts	`fraudAlerts`	`features`	Depends on alert
6	UI Interactions	`uiInteractions`	`features`	Behavioral Module
7	Typing	`typing`	`features`	Behavioral Module
8	Finger Gestures	`fingerGestures`	`features`	Behavioral Module
9	Touches	`touches`	`features`	Behavioral Module
10	Anomaly	`anomaly`	`features`	Behavioral Module

📘
Accessing API Fields
Discover how to retrieve the API fields listed below through the Dataset Insights API.

📌
Note
Our API typically returns non-null values as string. For type spec on each field, see the Data Type column in the tables below.
For detailed type specifications, check out the Type Specification

Device

Requires integration of Core Module

Field	Data Type	Description
`deviceId`	`string`	Unique device identifier. Max length: 100
`deviceIsSimulator`	`boolean`	Indicates whether the device is simulator or not
`deviceIsJailBroken`	`boolean`	Indicates whether the device is JailBroken or not
`deviceBrand`	`string`	Brand or manufacturer of the device. Max length: 100
`deviceModel`	`string`	Model of the device. Max length: 100
`deviceOsVersion`	`string`	Operating System version of the device. Max length: 100
`deviceScreenSize`	`string`	Screen size. Max length: 100
`deviceMainStorageTotal`	`float`	Total main storage in Megabytes
`deviceMainStorageFree`	`float`	Free main storage in Megabytes
`deviceRamTotalSize`	`float`	Total RAM size
`deviceLocationEnabled`	`boolean`	Indicates if location is enabled
`deviceAllowsVOIP`	`boolean`	Indicates if VOIP is allowed
`deviceAllowsVOIP2`	`boolean`	Indicates if VOIP is allowed on a second SIM card
`deviceCurrencyCode`	`string`	Currency code. Max length: 100
`deviceNetworkConnectionType`	`string`	Active network connection type. Max length: 100
`deviceLanguageCode`	`string`	Code for the primary language. Max length: 100
`deviceRegionCode`	`string`	Code for the region or country based on locale settings of the device. Max length: 100
`deviceTimeZoneId`	`string`	Time zone setting of the device. Max length: 100
`deviceLocaleDisplayLanguage`	`string`	Language for displaying text and UI. Max length: 100
`deviceBatteryIsCharging`	`boolean`	Indicates whether the battery is charging or not
`deviceBatteryStatus`	`float`	Indicates the current battery level in percentage (for ios only in case the battery monitoring is enabled)
`deviceCPUType`	`string`	The name of CPU type. Max length: 100
`deviceIsLying`	`boolean`	The approximate device position: is lying flat or not
`deviceIsAngled`	`boolean`	The approximate device position: is angled or not
`deviceIsStanding`	`boolean`	The approximate device position: is standing or not

Response body example (application/json)

{
   "code":"deviceInfo",
   "value":{
      "deviceId":"B01634BF-C7E6-4BA1-9384-3D862E8DF050",
      "deviceIsSimulator":"false",
      "deviceIsJailBroken":"false",
      "deviceBrand":"iPhone",
      "deviceModel":"iPhone12,5",
      "deviceOsVersion":"16.5",
      "deviceScreenSize":"2688x1242",
      "deviceMainStorageTotal":"60907.11328125",
      "deviceMainStorageFree":"38180.22265625",
      "deviceRamTotalSize":"3750.15625",
      "deviceLocationEnabled":"true",
      "deviceAllowsVOIP":"true",
      "deviceCurrencyCode":"UAH",
      "deviceNetworkConnectionType":"wifi",
      "deviceLanguageCode":"en",
      "deviceRegionCode":"UA",
      "deviceTimeZoneId":"Europe/Kiev",
      "deviceLocaleDisplayLanguage":"en_UA",
      "deviceBatteryIsCharging":"true",
      "deviceBatteryStatus":null,
      "deviceCPUType":"ARM_64",
      "deviceIsLying":"true",
      "deviceIsAngled":"false",
      "deviceIsStanding":"false"
   },
   "calculatedDate":"2023-08-14T08:29:27.853634Z"
}

Velocity

Requires integration of Core Module

Note: If a dataset IP address cannot be classified as an end-user IP (for example VPN was used), the associated feature will be null.

Field	Data Type	Description
`datasetsCountFromDeviceIdLastYear`	`integer`	Total number of datasets uploaded from the same device during last year
`datasetsCountFromIpLastYear`	`integer`	Total number of datasets uploaded from the same IP during last year
`datasetsCountFromDeviceIdAndIpLastYear`	`integer`	Total number of datasets uploaded from the same device and IP during last year
`datasetsUniqueIpFromDeviceIdLastYear`	`integer`	Unique IP addresses for given device during last year
`datasetsUniqueDeviceIdFromIpLastYear`	`integer`	Unique devices for given IP address during last year

Response body example (application/json)

{
   "code":"velocity",
   "value":{
      "datasetsCountFromDeviceIdLastYear": "10",
      "datasetsCountFromIpLastYear": "5",
      "datasetsCountFromDeviceIdAndIpLastYear": "1",
      "datasetsUniqueIpFromDeviceIdLastYear": "10",
      "datasetsUniqueDeviceIdFromIpLastYear": "2"
   },
   "calculatedDate":"2023-08-14T07:29:46.3156019Z"
}

IP Info

Requires integration of Core Module

📘
Note
If you're using a Proxy or Reverse Proxy configuration with the IP Info, ensure you submit the actual device IP address in your request

Field	Data Type	Description
`ip`	`string`	Unique identifier assigned to a device on a network. Max length: 100
`hostname`	`string`	Host name of an IP address. Max length: 100
`city`	`string`	Urban area where an IP address is located. Max length: 100
`region`	`string`	Geographical subdivision of a country where an IP address is situated. Max length: 100
`country`	`string`	Country where an IP address is registered. Max length: 100
`loc`	`string`	GPS location of area where an IP address is registered. Max length: 100
`postal`	`string`	Postal code associated with an IP address's location. Max length: 100
`timezone`	`string`	Standard time of an IP address's geographical area. Max length: 100
`privacyVpn`	`boolean`	Connection via VPN (IP address masking)
`privacyProxy`	`boolean`	Connection via proxy (IP address masking)
`privacyTor`	`boolean`	Connection via tor (IP address masking)
`privacyRelay`	`boolean`	Connection via privat relay (IP address masking)
`privacyHosting`	`boolean`	Connection via hosting provider (IP address masking)
`bogon`	`boolean`	Indicates whether the IP should never appear on the public internet. Appears only when true.

Response body example (application/json)

{
   "code":"ipInfo",
   "value":{
      "ip":"62.216.42.130",
      "hostname":null,
      "city":"Kyiv",
      "region":"Kyiv City",
      "country":"UA",
      "loc":"50.4547,30.5238",
      "postal":"03027",
      "timezone":"Europe/Kyiv",
      "privacyVpn":"true",
      "privacyProxy":"false",
      "privacyTor":"false",
      "privacyRelay":"false",
      "privacyHosting":"false",
      "bogon":"true"
   },
   "calculatedDate":"2023-08-14T08:29:27.8536353Z"
}

Apps Tracking

Requires integration of Application Module

Field	Data Type	Description
`isInstalled`	`integer`	Indicates whether an application of the particular URL Schema is installed
`urlSchemaName`	`string`	Name of the URL Schema

Response body example (application/json)

{
   "code":"application",
   "value":[
      {
         "isInstalled":"0",
         "urlSchemaName":"th.co.amoney"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"com.ntl.cxm-mobile"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"mtls"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"kbank.kplus"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"scbeasy"
      },
      {
         "isInstalled":"1",
         "urlSchemaName":"ktbnext"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"tmbtouch"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"krungsri-kma"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"bblapptoappmbanking"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"chaiyomobile"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"line3rdp.com.ccc.game.pcr"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"com.gameindy.dummyth"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"bornrich"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"goldwing-global"
      },
      {
         "isInstalled":"1",
         "urlSchemaName":"gsbmymo"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"com.scbabacus.l2020"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"monix"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"ghb-allgen"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"srisawadapp"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"com.huoys.royalcasinoonline"
      },
      {
         "isInstalled":"0",
         "urlSchemaName":"fb507039520732712"
      }
   ],
   "calculatedDate":"2023-08-14T08:29:27.8536343Z"
}

Fraud Alerts

Field	Data Type	Description	Required Modules
`riskEmulator`	`string`	Indicates if the device is running in a virtual environment.	Core Module
`riskRootedDevice`	`string`	Indicates if the host app's code has been modified to remove security restrictions that manufacturers put in place.	Core Module
`riskApplicationManipulation`	`string`	Indicates if the host app's code has been modified or tampered with after installation.	Core Module
`riskDeviceFarm`	`string`	Indicates if the device belongs to a large collection of phones controlled centrally for coordinated operations.	Core Module
`riskAutomation`	`string`	Indicates if the device is running automation tools that control apps without human interaction.	Behavioral Module
`riskHttpProxy`	`string`	Indicates if the device is routing traffic through an intermediary server that sits between the app and the internet.	Core Module
`riskTorUsage`	`string`	Indicates if the device is routing traffic through Tor that anonymizes connections through multiple encrypted layers.	Core Module
`riskVpnUsage`	`string`	Indicates if the device is routing internet traffic through encrypted tunnels that hide its true network origin.	Core Module
`riskLocationSpoofing`	`string`	Indicates if the device is broadcasting a fake GPS location that contradicts where it physically exists.	Location Module
`riskEmptyDevice`	`string`	Indicates if the device is empty.	Core Module
`riskGeographyMismatch`	`string`	Indicates if the device claims to be in a location that contradicts other geographic signals like network data.	Core Module
`riskFridaUsage`	`string`	Indicates if the device is running Frida, a tool that injects code into running apps to modify their behavior in real-time.	Core Module
`riskActiveCall`	`string`	Indicates if the device is on an active phone call while conducting financial transactions.	Telephony Module
`riskScreenCast`	`string`	Indicates if the device is broadcasting its screen to another display or device.	Core Module

Response body example (application/json):

{
    "code": "fraudAlerts",
    "value": {
        "riskEmulator": "high",
        "riskRootedDevice": "high",
        "riskApplicationManipulation": "low",
        "riskDeviceFarm": "high",
        "riskAutomation": "high",
        "riskHttpProxy": "low",
        "riskTorUsage": "high",
        "riskVpnUsage": "high",
        "riskLocationSpoofing": "low",
        "riskEmptyDevice": "high",
        "riskGeographyMismatch": "low",
        "riskFridaUsage": "low",
        "riskActiveCall": "low",
        "riskScreenCast": "low"
    },
    "calculatedDate": "2026-02-12T15:17:00.000000Z"
}

UI Interactions

Requires integration of Behavioral Module

Field	Data Type	Description	Is available on Flutter?
`inputDeleteActionsCount`	`integer`	Qty of all delete actions	Yes
`inputInsertActionsCount`	`integer`	Qty of all insert actions	Yes
`inputDeleteTextActionsCount`	`integer`	Qty of delete text actions	No
`inputInsertTextActionsCount`	`integer`	Qty of insert text actions	No
`textInputTextPrefilledCount`	`integer`	Qty of tracked first interaction with the element, and text input before length > 0. Could be affected by the date selection from the calendar picker	Yes
`applicationAsBackgroundCount`	`integer`	Qty of times when application was in the background	Yes
`applicationAsForegroundCount`	`integer`	Qty of times when application was in the foreground	Yes
`textInputTextRemovedAllCount`	`integer`	Qty of events when all text was removed	Yes
`clientInteractionsTimeSpentTotal`	`float`	The actual time spent on the direct interaction with the fields, excluding gaps between screens, seconds	Yes
`clientInteractionsTrackedEventsCount`	`integer`	Total count of tracked events during application form filling. Events = touch, pan, edge pan, swipe, text input	Yes

Response body example (application/json)

{
  "code": "uiInteractions",
  "calculatedDate": "2025-06-02T08:57:27.21084",
  "value": {
    "inputDeleteActionsCount": "1",
    "inputInsertActionsCount": "1",
    "inputDeleteTextActionsCount": "0",
    "inputInsertTextActionsCount": "1",
    "textInputTextPrefilledCount": "1",
    "applicationAsBackgroundCount": "4",
    "applicationAsForegroundCount": "3",
    "textInputTextRemovedAllCount": "1",
    "clientInteractionsTimeSpentTotal": "7.48899984359741",
    "clientInteractionsTrackedEventsCount": "15"
  }
}

Typing

Requires integration of Behavioral Module

Field	Data Type	Description	Is available on Flutter?
`textInputSpeed`	`float`	Only text input insert events are taken into the account, text inputs per second	Yes
`textInputLettersCount`	`integer`	Qty of events when a letter was typed in the "usual" way during fields filling (1 letter per 1 event)	Yes
`textInputNumbersCount`	`integer`	Qty of events when a number was typed in the "usual" way during fields filling (1 number per 1 event)	Yes
`inputStartWithLowerCount`	`integer`	Qty of times when user started to type field with a lower letter	Yes
`inputStartWithUpperCount`	`integer`	Qty of times when user started to type field with a upper letter	Yes
`inputStartWithNumberCount`	`integer`	Qty of times when user started to type field with a number	Yes
`textInputCharsExceptNumAndLettersCount`	`integer`	Qty of events when any other character (among symbols, punctuations, marks & separators) was typed in the field or when the number of pasted characters was greater than one per 1 event (incl. the date selection from the calendar picker)	Yes

Response body example (application/json)

{
  "code": "typing",
  "calculatedDate": "2025-06-02T08:57:27.210839",
  "value": {
    "textInputSpeed": "10.5633803053381",
    "textInputLettersCount": "8",
    "textInputNumbersCount": "0",
    "inputStartWithLowerCount": "1",
    "inputStartWithUpperCount": "0",
    "inputStartWithNumberCount": "0",
    "textInputCharsExceptNumAndLettersCount": "1"
  }
}

Finger Gestures

Requires integration of Behavioral Module

Field	Data Type	Description	Is available on Flutter?
`panPathLength`	`float`	Distance between all points of pan events	Yes
`swipePathLength`	`float`	Distance between all points of swipe events	Yes
`panTotalEventsCount`	`integer`	Total count of pan events	Yes
`scaleTotalEventsCount`	`integer`	Total count of scale events	No
`swipeTotalEventsCount`	`integer`	Total count of swipe events (similar to fling in Android)	Yes
`touchTotalEventsCount`	`integer`	Total count of touch events	Yes
`textInputTotalEventsCount`	`integer`	Total count of text input insert events	Yes
`touchActionsSpeed`	`float`	Measure of the performing of the touch actions, touches per second. Flutter only, for touchActionsSpeed on native iOS see Touches.	Yes

Response body example (application/json)

{
  "code": "fingerGestures",
  "calculatedDate": "2025-06-02T08:57:27.210839",
  "value": {
    "panPathLength": null,
    "swipePathLength": null,
    "panTotalEventsCount": null,
    "scaleTotalEventsCount": null,
    "swipeTotalEventsCount": null,
    "touchTotalEventsCount": "9",
    "textInputTotalEventsCount": "9",
    "touchActionsSpeed": "8.41908321031396",
  }
}

Touches

Requires integration of Behavioral Module

Field	Data Type	Description	Is available on Flutter?
`touchActionsSpeed`	`float`	Measure of the performing of the touch actions, touches per second	Yes
`panTotalNumberOfTouchesCount`	`integer`	Qty of touches during pan events	No
`scaleTotalNumberOfTouchesCount`	`integer`	Qty of touches during scale events	No

Response body example (application/json)

{
  "code": "touches",
  "calculatedDate": "2025-06-02T08:57:27.210839",
  "value": {
    "touchActionsSpeed": "8.41908321031396",
    "panTotalNumberOfTouchesCount": null,
    "scaleTotalNumberOfTouchesCount": null
  }
}

Anomaly

Requires integration of Behavioral Module

Field	Data Type	Description	Is available on Flutter?
`touchRageActionsCount`	`integer`	Qty of times when user made touch more than 5 times per second	Yes
`textInputRageActionsCount`	`integer`	Qty of times when user made text input more than 5 times per second	Yes

Response body example (application/json)

{
  "code": "anomaly",
  "calculatedDate": "2025-06-02T08:57:27.210837",
  "value": {
    "touchRageActionsCount": "0",
    "textInputRageActionsCount": "1"
  }
}

Type Specification

Type	Description	Example
`string`	A string is a sequence of characters. It can include letters, numbers, symbols, and spaces.	`"Europe/Kyiv"`
`boolean`	Boolean represents values `true` or `false`	`true`
`float`	Float represents decimal numbers with fractional parts	`3.142`
`integer`	Integer represents whole numbers without decimals	`42`
`datetime`	Date and time values expressed in UTC and have the following format `yyyy-mm-ddThh:mm:ss.ffffffZ`	`2023-08-14T08:29:27.8536352Z`