Android
Insights Overview
№ | Name | API Code | Required Module |
---|---|---|---|
1 | Device | deviceInfo | Core Module |
2 | Velocity | velocity | Core Module |
3 | IP Info | ipInfo | Core Module |
4 | Apps Info | appsInfo | Core Module v4.6.0+ |
5 | Fraud Alerts | fraudAlerts | Core Module v4.6.0+ |
6 | Last Installed Apps | lastApps | Core Module v4.6.0+ |
7 | Risky Apps | riskyApps | Core Module v4.6.0+ |
8 | Permissions | permissions | Core Module v4.6.0+ |
9 | Audio | audio | Audio Module |
10 | Calendar Events | calendar | Calendar Module |
11 | Contacts | contacts | Contacts Module |
12 | Images | images | Images Module |
13 | SMS | sms | SMS Module |
14 | Video | video | Video Module |
15 | UI Interactions | uiInteratctions | Behavioral Module |
16 | Finger Gestures | fingerGestures | Behavioral Module |
17 | Touches | touches | Behavioral Module |
18 | Typing | typing | Behavioral Module |
19 | Anomaly | anomaly | 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 latest Core Module
Field | Data Type | Description |
---|---|---|
deviceId | string | Unique device identifier. Max length: 100 |
deviceBrand | string | The brand with which the product/hardware will be associated. Max length: 100 |
deviceModel | string | Product name visible to the end user. Max length: 100 |
deviceOsVersion | string | Version of the operating system (Android). Max length: 100 |
deviceProduct | string | The name of the overall product. Max length: 100 |
deviceScreenSize | string | Screen resolution of the device. Max length: 100 |
deviceExternalStorageTotal | float | Total size of the device's external storage in Megabytes |
deviceExternalStorageFree | float | Available space of the device's external storage |
deviceMainStorageTotal | float | Total size of the storage on the device (data directory) |
deviceMainStorageFree | float | Available storage space on the device (data directory) in Megabytes |
deviceRamTotalSize | float | Total size of the RAM on the device |
deviceLocationEnabled | boolean | Indicates whether the device location is enabled or not |
deviceWifiIsEnabled | boolean | Indicates whether the WiFi is enabled or not |
deviceBluetoothOn | boolean | Indicates whether the bluetooth is enabled or not |
deviceDataRoaming | boolean | Indicates whether the data roaming is enabled or not |
deviceAccessibilityEnabled | boolean | Indicates whether the accessibility is enabled or not |
deviceBatteryIsCharging | boolean | Indicates whether the battery is charging or not |
deviceBatteryStatus | float | Indicates the current battery level in percentage |
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 |
deviceIsVirtual | boolean | Indicates if the device is running in a virtual environment |
deviceEmulatorName | string | Name of the virtual device emulator. Max length: 100 |
deviceIsRooted | boolean | Indicates if the device is rooted |
deviceIsFingerprintEnrolled | boolean | Indicates if there is at least one fingerprint enrolled |
deviceNextAlarmClock | datetime | The time at which the alarm is going to trigger (UTC) |
devicePhoneType | string | The phone type of the device: GSM, CDMA, etc. Max length: 100 |
deviceNetworkOperatorName | string | Name of the mobile network operator (only active SIM card is detected). Max length: 100 |
deviceSimCountryIso | string | ISO country code of the SIM card. Max length: 100 |
deviceLanguageCode | string | Code for the primary language. Max length: 100 |
deviceRegionCode | string | Code for the region or country setting. 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 |
deviceNetworkConnectionType | string | Active network connection type. Max length: 100 |
deviceHostAppIsCloned | boolean | Indicates if a host application is cloned. |
deviceUSBMassStorageEnabled | boolean | Indicates if USB MassStorage is enabled. |
deviceADBEnabled | boolean | Indicates if Android Debug Bridge is enabled. |
deviceDevelopmentSettingsEnabled | boolean | Indicates if Developer Mode is enabled. |
Response body example (application/json)
{
"code":"deviceInfo",
"value":{
"deviceBrand":"samsung",
"deviceModel":"SM-A528B",
"deviceOsVersion":"13",
"deviceProduct":"a52sxqeea",
"deviceScreenSize":"1080x2400",
"deviceExternalStorageTotal":"61024",
"deviceExternalStorageFree":"34686.875",
"deviceMainStorageTotal":"108865.984375",
"deviceMainStorageFree":"65761.796875",
"deviceRamTotalSize":"5367.4609375",
"deviceLocationEnabled":"false",
"deviceWifiIsEnabled":"true",
"deviceBluetoothOn":"false",
"deviceDataRoaming":"true",
"deviceAccessibilityEnabled":"false",
"deviceBatteryIsCharging":"false",
"deviceBatteryStatus":"0.76",
"deviceCPUType":"arm64-v8a;armeabi-v7a;armeabi",
"deviceIsLying":"false",
"deviceIsAngled":"true",
"deviceIsStanding":"false",
"deviceIsFingerprintEnrolled":"1",
"deviceNextAlarmClock":"2023-08-14 09:20:00",
"devicePhoneType":"1",
"deviceIsVirtual":"false",
"deviceId":"fe533e40da103950ac649cf1a0090404",
"deviceEmulatorName":null,
"deviceIsRooted":"false",
"deviceNetworkOperatorName":"KAKTUS",
"deviceSimCountryIso":"cz",
"deviceLanguageCode":"eng",
"deviceRegionCode":"GBR",
"deviceTimeZoneId":"Europe/Prague",
"deviceLocaleDisplayLanguage":"English",
"deviceNetworkConnectionType":"wifi",
"deviceHostAppIsCloned":"false",
"deviceUSBMassStorageEnabled":"false",
"deviceADBEnabled":"false",
"deviceDevelopmentSettingsEnabled":"false"
},
"calculatedDate":"2023-08-14T07:29:46.315602Z"
}
Velocity
Requires integration of latest 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 latest 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 the IP address is registered. Max length: 100 |
postal | string | Postal code associated with the IP address location. Max length: 100 |
timezone | string | Standard time of the IP address 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) |
Response body example (application/json)
{
"code":"ipInfo",
"value":{
"ip":"178.72.203.93",
"hostname":"host-178-72-203-93.ip.nej.cz",
"city":"Prague",
"region":"Prague",
"country":"CZ",
"loc":"50.0880,14.4208",
"postal":"110 00",
"timezone":"Europe/Prague",
"privacyVpn":"false",
"privacyProxy":"false",
"privacyTor":"false",
"privacyRelay":"false",
"privacyHosting":"false"
},
"calculatedDate":"2023-08-14T07:29:46.3156018Z"
}
Fraud Alerts
Field | Data Type | Description |
---|---|---|
riskEmulator | string | Indicates if the device is running in a virtual environment |
riskTorUsage | string | Indicates if there is a risk of using TOR |
riskVpnUsage | string | Indicates if there is a risk of using VPN |
riskHttpProxy | string | Indicates if there a risk of HTTP Proxy is configured |
riskNewDevice | string | Indicates if the device is new |
riskAutomation | string | Indicates if there is a risk of automation |
riskDeviceFarm | string | Indicates if there is a risk of device farm |
riskEmptyDevice | string | Indicates if the device is empty |
riskRemoteAccess | string | Indicates whether the device can be accessed remotely |
riskRootedDevice | string | Indicates if the device is rooted |
riskCryptoEnthusiast | string | Indicates if a device belongs to a crypto enthusiast |
riskLocationSpoofing | string | Indicates whether the location can be spoofed |
riskTimeManipulation | string | Indicates whether the time or timezone may have been manipulated |
riskGeographyMismatch | string | Indicates whether there is mismatch in geography |
riskTemporaryEmailUsage | string | Indicates if there is a risk of using temporary email apps |
riskDeviceIdChangerUsage | string | Indicates if there is a risk of cnanging device ID |
riskHostApplicationCloned | string | Indicates if a host application is cloned |
riskApplicationClonerUsage | string | Indicates if there is a risk of clonning applications |
riskControlledFromComputer | string | Indicates if there is a risk that a user manipulates the device from computer |
riskAnonymousMessengerUsage | string | Indicates if there is a risk of using anonymous messengers |
riskApplicationManipulation | string | Indicates if there is a risk of the host application manipulation |
riskApplicationGamblingUsage | string | Indicates if a device belongs to a gambler |
riskNonMarketApplicationUsage | string | Indicates if the host application installed not from official app markets |
riskHostApplicationNotInstalledFromMarket | string | Indicates if other applications could be installed not from official app markets |
riskFinancialApplicationsInstallationSurge | string | Indicates a surge in financial apps installation |
Response body example (application/json)
{
"code": "fraudAlerts",
"value": {
"riskEmulator": "low",
"riskTorUsage": "low",
"riskVpnUsage": "low",
"riskHttpProxy": "low",
"riskNewDevice": "low",
"riskAutomation": "low",
"riskDeviceFarm": "low",
"riskEmptyDevice": "high",
"riskRemoteAccess": "low",
"riskRootedDevice": "low",
"riskCryptoEnthusiast": "low",
"riskLocationSpoofing": "low",
"riskTimeManipulation": "low",
"riskGeographyMismatch": "high",
"riskTemporaryEmailUsage": "low",
"riskDeviceIdChangerUsage": "low",
"riskHostApplicationCloned": "low",
"riskApplicationClonerUsage": "low",
"riskControlledFromComputer": "high",
"riskAnonymousMessengerUsage": "low",
"riskApplicationManipulation": "high",
"riskApplicationGamblingUsage": "low",
"riskNonMarketApplicationUsage": "high",
"riskHostApplicationNotInstalledFromMarket": "low",
"riskFinancialApplicationsInstallationSurge": "low"
},
"calculatedDate": "2025-02-27T11:13:33.559676Z"
}
Apps Info
Requires integration of Core Module v4.6.0+
Field | Data Type | Description |
---|---|---|
deviceAgeSinceFirstAppInstallByUser | float | Estimated duration since installation of first user application |
appsTotalCount | integer | Total number of installed applications |
appsSystemCount | integer | Total number of system-preinstalled applications |
appsUserCount | integer | Total number of applications installed by user himself |
appsUserInstalledLast30DaysCount | integer | Total number of applications installed by user in the last 30 days |
appsUserInstalledLast3MonthsCount | integer | Total number of applications installed by user in the last 3 months |
appsUserInstalledLast6MonthsCount | integer | Total number of applications installed by user in the last 6 months |
appsUserInstalledLast12MonthsCount | integer | Total number of applications installed by user in the last 12 months |
appsInstalledLast30DaysCount | integer | Total number of applications installed in the last 30 days |
appsPaidCount | integer | Total number of applications installed by user and marked as paid apps in Google Play |
appsFreeCount | integer | Total number of applications installed by user and marked as free apps in Google Play |
appsContentRating3+ | integer | Total number of applications with content rating 3+ according to the Google Play Market |
appsContentRating7+ | integer | Total number of applications with content rating 7+ according to the Google Play Market |
appsContentRating12+ | integer | Total number of applications with content rating 12+ according to the Google Play Market |
appsContentRating16+ | integer | Total number of applications with content rating 16+ according to the Google Play Market |
appsContentRating18+ | integer | Total number of applications with content rating 18+ according to the Google Play Market |
appsArtsAndEntertainmentCount | integer | Number of applications with "Arts and Entertainment" category |
appsGamesCount | integer | Number of applications with "Games" category |
appsSocialAndCommunicationsCount | integer | Number of applications with "Social and Communications" category |
appsToolAndUtilitiesCount | integer | Number of applications with "Tools and Utilities" category |
appsOthersCount | integer | Number of applications with other rare categories |
appsMissingCount | integer | Number of applications that weren't found in Google Play Market |
appsArtAndDesignCount | integer | Number of applications with "ArtAndDesign" category |
appsBooksAndReferenceCount | integer | Number of applications with "BooksAndReference" category |
appsComicsCount | integer | Number of applications with "Comics" category |
appsEntertainmentCount | integer | Number of applications with "Entertainment" category |
appsPhotographyCount | integer | Number of applications with "Photography" category |
appsVideoPlayersAndEditorsCount | integer | Number of applications with "VideoPlayersAndEditors" category |
appsEducationCount | integer | Number of applications with "Education" category |
appsGamesActionCount | integer | Number of applications with "GamesAction" category |
appsGamesAdventureCount | integer | Number of applications with "GamesAdventure" category |
appsGamesArcadeCount | integer | Number of applications with "GamesArcade" category |
appsGamesBoardCount | integer | Number of applications with "GamesBoard" category |
appsGamesCardCount | integer | Number of applications with "GamesCard" category |
appsGamesCasinoCount | integer | Number of applications with "GamesCasino" category |
appsGamesCasualCount | integer | Number of applications with "GamesCasual" category |
appsGamesEducationalCount | integer | Number of applications with "GamesEducational" category |
appsGamesMusicCount | integer | Number of applications with "GamesMusic" category |
appsGamesPuzzleCount | integer | Number of applications with "GamesPuzzle" category |
appsGamesRacingCount | integer | Number of applications with "GamesRacing" category |
appsGamesRolePlayingCount | integer | Number of applications with "GamesRolePlaying" category |
appsGamesSimulationCount | integer | Number of applications with "GamesSimulation" category |
appsGamesStrategyCount | integer | Number of applications with "GamesStrategy" category |
appsGamesTriviaCount | integer | Number of applications with "GamesTrivia" category |
appsGamesWordCount | integer | Number of applications with "GamesWord" category |
appsBeautyCount | integer | Number of applications with "Beauty" category |
appsDatingCount | integer | Number of applications with "Dating" category |
appsFoodAndDrinkCount | integer | Number of applications with "Food And Drink" category |
appsHealthAndFitnessCount | integer | Number of applications with "HealthAndFitness" category |
appsLifestyleCount | integer | Number of applications with "Lifestyle" category |
appsMapsAndNavigationCount | integer | Number of applications with "MapsAndNavigation" category |
appsMusicAndAudioCount | integer | Number of applications with "MusicAndAudio" category |
appsShoppingCount | integer | Number of applications with "Shopping" category |
appsTravelAndLocalCount | integer | Number of applications with "TravelAndLocal" category |
appsAutoVehiclesCount | integer | Number of applications with "AutoVehicles" category |
appsBusinessCount | integer | Number of applications with "Business" category |
appsHouseAndHomeCount | integer | Number of applications with "HouseAndHome" category |
appsLibrariesDemoCount | integer | Number of applications with "LibrariesDemo" category |
appsMedicalCount | integer | Number of applications with "Medical" category |
appsNewsMagazinesCount | integer | Number of applications with "NewsMagazines" category |
appsParentingCount | integer | Number of applications with "Parenting" category |
appsSportsCount | integer | Number of applications with "Sports" category |
appsPersonalizationCount | integer | Number of applications with "Personalization" category |
appsFinanceCount | integer | Number of applications with "Finance" category |
appsProductivityCount | integer | Number of applications with "Productivity" category |
appsCommunicationCount | integer | Number of applications with "Communication" category |
appsSocialCount | integer | Number of applications with "Social" category |
appsEventsCount | integer | Number of applications with "Events" category |
appsToolsCount | integer | Number of applications with "Tools" category |
appsWeatherCount | integer | Number of applications with "Weather" category |
Response body example (application/json)
{
"code":"appsInfo",
"value":{
"deviceAgeSinceFirstAppInstallByUser":"13498.3642958333",
"appsTotalCount":"476",
"appsSystemCount":"405",
"appsUserCount":"71",
"appsUserInstalledLast30DaysCount":"2",
"appsUserInstalledLast3MonthsCount":"5",
"appsUserInstalledLast6MonthsCount":"7",
"appsUserInstalledLast12MonthsCount":"15",
"appsInstalledLast30DaysCount":"2",
"appsPaidCount":"1",
"appsFreeCount":"96",
"appsContentRating3+":"85",
"appsContentRating7+":"1",
"appsContentRating12+":"3",
"appsContentRating16+":"7",
"appsContentRating18+":"0",
"appsArtsAndEntertainmentCount":"7",
"appsGamesCount":"4",
"appsSocialAndCommunicationsCount":"18",
"appsToolAndUtilitiesCount":"19",
"appsOthersCount":"10",
"appsMissingCount":"379",
"appsArtAndDesignCount":"0",
"appsBooksAndReferenceCount":"1",
"appsComicsCount":"0",
"appsEntertainmentCount":"3",
"appsPhotographyCount":"2",
"appsVideoPlayersAndEditorsCount":"1",
"appsEducationCount":"2",
"appsGamesActionCount":"0",
"appsGamesAdventureCount":"0",
"appsGamesArcadeCount":"0",
"appsGamesBoardCount":"3",
"appsGamesCardCount":"0",
"appsGamesCasinoCount":"0",
"appsGamesCasualCount":"0",
"appsGamesEducationalCount":"0",
"appsGamesMusicCount":"0",
"appsGamesPuzzleCount":"1",
"appsGamesRacingCount":"0",
"appsGamesRolePlayingCount":"0",
"appsGamesSimulationCount":"0",
"appsGamesStrategyCount":"0",
"appsGamesTriviaCount":"0",
"appsGamesWordCount":"0",
"appsBeautyCount":"0",
"appsDatingCount":"0",
"appsFoodAndDrinkCount":"0",
"appsHealthAndFitnessCount":"4",
"appsLifestyleCount":"0",
"appsMapsAndNavigationCount":"5",
"appsMusicAndAudioCount":"1",
"appsShoppingCount":"1",
"appsTravelAndLocalCount":"7",
"appsAutoVehiclesCount":"1",
"appsBusinessCount":"8",
"appsHouseAndHomeCount":"0",
"appsLibrariesDemoCount":"0",
"appsMedicalCount":"0",
"appsNewsMagazinesCount":"1",
"appsParentingCount":"0",
"appsSportsCount":"0",
"appsPersonalizationCount":"1",
"appsFinanceCount":"11",
"appsProductivityCount":"7",
"appsCommunicationCount":"16",
"appsSocialCount":"2",
"appsEventsCount":"0",
"appsToolsCount":"19",
"appsWeatherCount":"0"
},
"calculatedDate":"2023-08-14T07:29:46.3156006Z"
}
Last Installed Apps
Requires integration of Core Module v4.6.0+
Field | Data Type | Description |
---|---|---|
appPackageName | string | Package name of the app (last 5 installed apps are displayed). Max length: 100 |
appGooglePlayCategory | string | GooglePlay category of the application (last 5 installed apps are displayed). Max length: 100 |
appDateInstalled | datetime | Datetime when app was installed for the first time (last 5 installed apps are displayed) |
appDateLastUpdated | datetime | Datetime when app was updated last time (last 5 installed apps are displayed) |
appPaid | boolean | Indicates if the application is paid or free (last 5 installed apps are displayed) |
appContentRatings | string | App's rating according to the Google Play Market (last 5 installed apps are displayed). Max length: 100 |
appDateInstalledRankDesc | integer | Order of the app based installed date (1 = last installed app) |
Response body example (application/json)
{
"code":"lastApps",
"value":[
{
"appPackageName":"com.transferwise.android",
"appGooglePlayCategory":"finance",
"appDateInstalled":"2023-07-31 20:08:14.496",
"appDateLastUpdated":"2023-08-10 23:56:55.50",
"appPaid":"false",
"appContentRatings":"rated for 3+",
"appDateInstalledRankDesc":"1"
},
{
"appPackageName":"com.credolab.play",
"appGooglePlayCategory":null,
"appDateInstalled":"2023-07-21 14:44:22.63",
"appDateLastUpdated":"2023-07-21 14:44:22.63",
"appPaid":"false",
"appContentRatings":null,
"appDateInstalledRankDesc":"2"
},
{
"appPackageName":"com.google.android.apps.walletnfcrel",
"appGooglePlayCategory":"finance",
"appDateInstalled":"2023-06-17 14:28:25.361",
"appDateLastUpdated":"2023-08-02 19:04:12.907",
"appPaid":"false",
"appContentRatings":"rated for 3+",
"appDateInstalledRankDesc":"3"
},
{
"appPackageName":"com.google.ar.lens",
"appGooglePlayCategory":"tools",
"appDateInstalled":"2023-06-17 13:55:50.417",
"appDateLastUpdated":"2023-07-02 00:41:40.796",
"appPaid":"false",
"appContentRatings":"rated for 3+",
"appDateInstalledRankDesc":"4"
},
{
"appPackageName":"com.credoapply",
"appGooglePlayCategory":"finance",
"appDateInstalled":"2023-06-15 15:41:57.598",
"appDateLastUpdated":"2023-07-20 20:57:39.875",
"appPaid":"false",
"appContentRatings":"rated for 3+",
"appDateInstalledRankDesc":"5"
}
],
"calculatedDate":"2023-08-14T07:29:46.3156003Z"
}
Risky Apps
Requires integration of Core Module v4.6.0+
Field | Data Type | Description |
---|---|---|
appClonerFlag | boolean | Presence of App Cloner installation on the phone |
anonymousMessengerFlag | boolean | Presence of an anonymous messenger app on the phone |
callCenterFlag | boolean | Presence of a call center app on the phone |
TorBrowserFlag | boolean | Presence of Tor Browser installation on the phone |
temporaryEmailFlag | boolean | Presence of a temporary email app on the phone |
vpnFlag | boolean | Presence of a VPN (Virtual Private Network) app on the phone |
locationSpoofingFlag | boolean | Presence of location spoofing functionality or app on the phone |
appHiderFlag | boolean | Presence of app hider app on the phone |
virtualAndroidFlag | boolean | Presence of virtual android app on the phone |
deveiceIdChangerFlag | boolean | Presence of device ID changing funcitonality or app on the phone |
desktopMobileBridgeFlag | boolean | Presence of app with controling phone from PC functionality |
Response body example (application/json)
{
"code":"risky_apps",
"value":{
"appClonerFlag":"0",
"anonymousMessengerFlag":"1",
"callCenterFlag":"0",
"TorBrowserFlag":"0",
"temporaryEmailFlag":"0",
"vpnFlag":"1",
"locationSpoofingFlag":"0",
"appHiderFlag":"0",
"virtualAndroidFlag":"0",
"deviceIdChangerFlag":"0",
"desktopMobileBridgeFlag":"0"
},
"calculatedDate":"2023-10-06T13:21:27.190941Z"
}
Permissions
Field | Data Type | Description |
---|---|---|
readContacts | integer | Permission that allows reading metadata related to Contacts and Contacts Group |
readExternalStorage | integer | Permission that allows reading metadata related to the media files |
readMediaAudio | integer | Permission that allows reading metadata related to the audio files |
readMediaImages | integer | Permission that allows reading metadata related to the image files |
readMediaVideo | integer | Permission that allows reading metadata related to the video files |
readCalendar | integer | Permission that allows reading metadata related to the calendar information presented on the device. The metadata includes calendars such as Events, Attendees, Reminders. |
getAccounts | integer | Permission that allows reading metadata related to the user's accounts on the device. For example Gmail, Facebook, etc |
accessWifiState | integer | Permission that allows reading metadata related to the wifi |
useFingerprint | integer | Permission that allows reading metadata related to the device's fingerprint |
accessNetworkState | integer | Permission that allows reading metadata related to the network |
readSms | integer | Permission that allows reading metadata related to SMS |
Response body example (application/json)
{
"code":"permissions",
"value":{
"readContacts":"1",
"readExternalStorage":null,
"readMediaAudio":"1",
"readMediaImages":"1",
"readMediaVideo":"1",
"readCalendar":"1",
"getAccounts":"1",
"accessWifiState":"1",
"useFingerprint":"1",
"accessNetworkState":"1",
"readSms":"1"
},
"calculatedDate":"2023-08-14T07:29:46.3155998Z"
}
Permission Value Description
Value | Description |
---|---|
null | The corresponding SDK module is not integrated |
-1 | Permission is not included in the manifest |
0 | Permission is not granted |
1 | Permission is granted |
Audio
Requires integration of Audio Module
Field | Data Type | Description |
---|---|---|
audioCount | integer | Total number of audio files |
audioMusicCount | integer | Total number of "music" audio files |
The values in the API response will be
null
if the permission is not granted or there is no data available
Response body example (application/json)
{
"code":"audio",
"value":{
"audioCount":"426",
"audioMusicCount":"398"
},
"calculatedDate":"2023-08-14T07:29:46.3156014Z"
}
Calendar Events
Requires integration of Calendar Module
Field | Data Type | Description |
---|---|---|
calendarEventsPastCount | integer | Total number of past events |
calendarEventsTotalCount | integer | Total number of events |
calendarEventsAsOrganizerCount | integer | Total number of organized events |
calendarEventsStatusConfirmedCount | integer | Total number of events with confirmed status |
calendarEventsDuringWeekdayCount | integer | Total number of events during the weekdays |
calendarEventsMoreThan1AttendeeCount | integer | Total number of events with more than 1 attendee |
calendarEventsDifferentTimeZonesCount | integer | Total number of events in different time zone |
calendarEventsLast30DaysCount | integer | Total number of events in the last 30 days |
calendarEventsNext30DaysCount | integer | Total number of events in the next 30 days |
calendarEventsLast30DaysRepetitiveCount | integer | Total number of repetitive events in the last 30 days |
calendarEventsDuringWeekdayLast30DaysCount | integer | Total number of events during the weekdays in the last 30 days |
The values in the API response will be
null
if the permission is not granted or there is no data available
Response body example (application/json)
{
"code":"calendar",
"value":{
"calendarEventsPastCount":"2764",
"calendarEventsTotalCount":"2988",
"calendarEventsAsOrganizerCount":"1074",
"calendarEventsStatusConfirmedCount":"2717",
"calendarEventsDuringWeekdayCount":"2907",
"calendarEventsMoreThan1AttendeeCount":"2373",
"calendarEventsDifferentTimeZonesCount":"64",
"calendarEventsLast30DaysCount":"80",
"calendarEventsNext30DaysCount":"15",
"calendarEventsLast30DaysRepetitiveCount":"30",
"calendarEventsDuringWeekdayLast30DaysCount":"80"
},
"calculatedDate":"2023-08-14T07:29:46.315601Z"
}
Contacts
Requires integration of Contact Module
Field | Data Type | Description |
---|---|---|
contactsTotalCount | integer | Total number of contacts |
contactsWithoutNumberCount | integer | Total number of contacts without any phone number |
contactsMultipleNumbersCount | integer | Total number of contacts with multiple associated phone numbers |
contactsStaredCount | integer | Total number of contacts marked as "Favourites" |
contactsWithPictureCount | integer | Total number of contacts with associated picture |
contactsWithRingtoneCount | integer | Total number of contacts with a special ringtone |
phoneNumberTotalCount | integer | Total number of phone numbers |
phoneNumberMobileCount | integer | Total number of phone numbers in category "Mobile" |
phoneNumberWorkCount | integer | Total number of phone numbers in category "Work" |
phoneNumberHomeCount | integer | Total number of phone numbers in category "Home" |
phoneNumberOtherCount | integer | Total number of phone numbers in category "Other" |
contactsWhatsAppCount | integer | Total number of contacts with linked WhatsApp |
contactsTelegramCount | integer | Total number of contacts with linked Telegram |
contactsMeetCount | integer | Total number of contacts with linked Meet |
contactsSkypeCount | integer | Total number of contacts with linked Skype |
contactsViberCount | integer | Total number of contacts with linked Viber |
contactsZoomCount | integer | Total number of contacts with linked Zoom |
contactsLineCount | integer | Total number of contacts with linked Line |
The values in the API response will be
null
if the permission is not granted or there is no data available
Response body example (application/json)
{
"code":"contacts",
"value":{
"contactsTotalCount":"174",
"contactsWithoutNumberCount":"1",
"contactsMultipleNumbersCount":"108",
"contactsStaredCount":"1",
"contactsWithPictureCount":"1",
"contactsWithRingtoneCount":"0",
"phoneNumberTotalCount":"295",
"phoneNumberMobileCount":"281",
"phoneNumberWorkCount":"3",
"phoneNumberHomeCount":"9",
"phoneNumberOtherCount":"2",
"contactsWhatsAppCount":"148",
"contactsTelegramCount":"0",
"contactsMeetCount":"0",
"contactsSkypeCount":"0",
"contactsViberCount":"173",
"contactsZoomCount":"0",
"contactsLineCount":"1"
},
"calculatedDate":"2023-08-14T07:29:46.3156007Z"
}
Images
Requires integration of Images Module
Field | Data Type | Description |
---|---|---|
imagesCount | integer | Total number of images |
imagesCountWithLocation | integer | Total number of images with location property |
imageResolution | string | Most frequent image resolution. Max length: 100 |
imagesLast30DaysCount | integer | Total number of images created in the last 30 days |
imagesLast360DaysCount | integer | Total number of images created in the last 360 days |
imagesFirstMonth10Images | string | First month with more than 10 images. Max length: 100 |
imagesCameraCount | integer | Total number of images taken by camera |
imagesCameraLast30DaysCount | integer | Total number of images taken by camera created in last 30 days |
The values in the API response will be
null
if the permission is not granted or there is no data available
Response body example (application/json)
{
"code":"images",
"value":{
"imagesCount":"7929",
"imagesCountWithLocation":"0",
"imageResolution":"4624x3468",
"imagesLast30DaysCount":"156",
"imagesLast360DaysCount":"1249",
"imagesFirstMonth10Images":"2022-01",
"imagesCameraCount":"1716",
"imagesCameraLast30DaysCount":"80"
},
"calculatedDate":"2023-08-14T07:29:46.3156012Z"
}
SMS
Requires integration of Sms Module
Field | Data Type | Description |
---|---|---|
smsInboxCount | integer | The total number of SMS in Inbox |
smsInboxSeenCount | integer | The total number of SMS in Inbox with status "Seen" |
smsInboxReadCount | integer | The total number of SMS in Inbox with status "Read" |
smsInboxKnownNumberCount | integer | The total number of SMS in Inbox from known number |
smsOutboxCount | integer | The total number of SMS in Outbox |
smsOutboxDuringWeekdayCount | integer | The total number of SMS in Outbox sent during weekdays |
The values in the API response will be
null
if the permission is not granted or there is no data available
Response body example (application/json)
{
"code":"sms",
"value":{
"smsInboxCount":"218",
"smsInboxSeenCount":"217",
"smsInboxReadCount":"216",
"smsInboxKnownNumberCount":"33",
"smsOutboxCount":"22",
"smsOutboxDuringWeekdayCount":"14"
},
"calculatedDate":"2023-08-14T07:29:46.3156011Z"
}
Video
Requires integration of Video Module
Field | Data Type | Description |
---|---|---|
videoCount | integer | Total number of video files |
videoLast30DaysCount | integer | Total number of video files created in the last 30 days |
videoCameraCount | integer | Total number of videos taken by camera |
videoCameraLast30DaysCount | integer | Total number of videos taken by camera in the last 30 days |
The values in the API response will be
null
if the permission is not granted or there is no data available
Response body example (application/json)
{
"code":"video",
"value":{
"videoCount":"153",
"videoLast30DaysCount":"2",
"videoCameraCount":"31",
"videoCameraLast30DaysCount":"0"
},
"calculatedDate":"2023-08-14T07:29:46.3156016Z"
}
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 | Yes |
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 |
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 |
clientActivitySessionTimeSpentTotal | float | The total time that the app was open and active (foreground time), in seconds | Yes |
clientInteractionsTrackedEventsCount | integer | Total count of tracked events during application form filling. Events = touch, text input | Yes |
Response body example (application/json)
{
"code": "uiInteractions",
"calculatedDate": "2025-06-02T08:44:21.55265",
"value": {
"inputDeleteActionsCount": "0",
"inputInsertActionsCount": "0",
"inputDeleteTextActionsCount": "0",
"inputInsertTextActionsCount": "0",
"textInputTextPrefilledCount": "1",
"textInputTextRemovedAllCount": "0",
"clientInteractionsTimeSpentTotal": "4.13100004196167",
"clientActivitySessionTimeSpentTotal": "76.6300001144409",
"clientInteractionsTrackedEventsCount": "12"
}
}
Finger Gestures
Requires integration of Behavioral Module
Field | Data Type | Description | Is available on Flutter? |
---|---|---|---|
flingTotalEventsCount | integer | Total count of fling events (similar to swipe in iOS) | No |
scaleTotalEventsCount | integer | Total count of scale events | No |
touchTotalEventsCount | integer | Total count of touch events | Yes |
scrollTotalEventsCount | integer | Total count of scroll events (similar to pan / move in iOS) | No |
textInputTotalEventsCount | integer | Total count of text input insert events | Yes |
flingCoordinatesDistanceAvg | float | Average distance between coordinates of the fling events, pixels | No |
scrollCoordinatesDistanceAvg | float | Average distance between coordinates of the scroll events, pixels | No |
Response body example (application/json)
{
"code": "fingerGestures",
"calculatedDate": "2025-06-02T08:44:21.552651",
"value": {
"flingTotalEventsCount": "4",
"scaleTotalEventsCount": null,
"touchTotalEventsCount": "11",
"scrollTotalEventsCount": "4",
"textInputTotalEventsCount": "1",
"flingCoordinatesDistanceAvg": "213.299239525673",
"scrollCoordinatesDistanceAvg": "77.520437196023"
}
}
Touches
Requires integration of Behavioral Module
Field | Data Type | Description | Is available on Flutter? |
---|---|---|---|
touchOnDownCount | integer | Qty of touch down events | No |
touchOnDoubleTapCount | integer | Qty of double tap events | No |
touchOnLongPressCount | integer | Qty of long press events | No |
Response body example (application/json)
{
"code": "touches",
"calculatedDate": "2025-06-02T08:44:21.55265",
"value": {
"touchOnDownCount": "11",
"touchOnDoubleTapCount": "4",
"touchOnLongPressCount": "0"
}
}
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:44:21.552504",
"value": {
"textInputSpeed": "0.34",
"textInputLettersCount": "0",
"textInputNumbersCount": "0",
"inputStartWithLowerCount": "0",
"inputStartWithUpperCount": "0",
"inputStartWithNumberCount": "0",
"textInputCharsExceptNumAndLettersCount": "1"
}
}
Anomaly
Requires integration of Behavioral Module
Field | Data Type | Description | Is available on Flutter? |
---|---|---|---|
flingRageActionsCount | integer | Qty of times when user made fling actions more than 5 times per second | No |
scaleRageActionsCount | integer | Qty of times when user made scale actions more than 5 times per second | No |
touchRageActionsCount | integer | Qty of times when user made touch more than 5 times per second | Yes |
scrollRageActionsCount | integer | Qty of times when user made scroll actions more than 5 times per second | No |
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:44:21.552651",
"value": {
"flingRageActionsCount": "0",
"scaleRageActionsCount": null,
"touchRageActionsCount": "0",
"scrollRageActionsCount": "0",
"textInputRageActionsCount": "0"
}
}
Type Specification
Requires integration of Behavioral Module
Type | Description | Example |
---|---|---|
| A string is a sequence of characters. It can include letters, numbers, symbols, and spaces. |
|
| Boolean represents values |
|
| Float represents decimal numbers with fractional parts |
|
| Integer represents whole numbers without decimals |
|
| Date and time values expressed in UTC and have the following format
|
|
Updated 17 days ago