You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
|**category**|**String**| The type and purpose of the bot. ||
12
12
|**provider**|**String**| The organization or company operating the bot. ||
13
-
|**providerUrl**|**String**| The URL of the bot provider's website. |[optional]|
13
+
|**providerUrl**|**String**| The URL of the bot provider's website. |[optional]|
14
14
|**name**|**String**| The specific name or identifier of the bot. ||
15
-
|**identity**|[**IdentityEnum**](#IdentityEnum)| The verification status of the bot's identity: * `verified` - well-known bot with publicly verifiable identity, directed by the bot provider. * `signed` - bot that signs its platform via Web Bot Auth, directed by the bot provider’s customers. * `spoofed` - bot that claims a public identity but fails verification. * `unknown` - bot that does not publish a verifiable identity. ||
15
+
|**identity**|[**IdentityEnum**](#IdentityEnum)| The verification status of the bot's identity: * `verified` - well-known bot with publicly verifiable identity, directed by the bot provider. * `signed` - bot that signs its platform via Web Bot Auth, directed by the bot provider’s customers. * `spoofed` - bot that claims a public identity but fails verification. * `unknown` - bot that does not publish a verifiable identity. ||
16
16
|**confidence**|[**ConfidenceEnum**](#ConfidenceEnum)| Confidence level of the bot identification. ||
|**eventId**|**String**| Unique identifier of the user's request. The first portion of the event_id is a unix epoch milliseconds timestamp For example: `1758130560902.8tRtrH`||
11
+
|**eventId**|**String**| Unique identifier of the user's request. The first portion of the event_id is a unix epoch milliseconds timestamp For example: `1758130560902.8tRtrH`||
12
12
|**timestamp**|**Long**| Timestamp of the event with millisecond precision in Unix time. ||
13
13
|**linkedId**|**String**| A customer-provided id that was sent with the request. |[optional]|
14
-
|**environmentId**|**String**| Environment Id of the event. For example: `ae_47abaca3db2c7c43`|[optional]|
15
-
|**suspect**|**Boolean**| Field is `true` if you have previously set the `suspect` flag for this event using the [Server API Update event endpoint](https://dev.fingerprint.com/reference/updateevent). |[optional]|
14
+
|**environmentId**|**String**| Environment Id of the event. For example: `ae_47abaca3db2c7c43`|[optional]|
15
+
|**suspect**|**Boolean**| Field is `true` if you have previously set the `suspect` flag for this event using the [Server API Update event endpoint](https://dev.fingerprint.com/reference/updateevent). |[optional]|
16
16
|**sdk**|[**SDK**](SDK.md)||[optional]|
17
-
|**replayed**|**Boolean**|`true` if we determined that this payload was replayed, `false` otherwise. |[optional]|
17
+
|**replayed**|**Boolean**|`true` if we determined that this payload was replayed, `false` otherwise. |[optional]|
|**tags**|**Object**| A customer-provided value or an object that was sent with the identification request or updated later. |[optional]|
21
-
|**url**|**String**| Page URL from which the request was sent. For example `https://example.com/`|[optional]|
22
-
|**bundleId**|**String**| Bundle Id of the iOS application integrated with the Fingerprint SDK for the event. For example: `com.foo.app`|[optional]|
23
-
|**packageName**|**String**| Package name of the Android application integrated with the Fingerprint SDK for the event. For example: `com.foo.app`|[optional]|
21
+
|**url**|**String**| Page URL from which the request was sent. For example `https://example.com/`|[optional]|
22
+
|**bundleId**|**String**| Bundle Id of the iOS application integrated with the Fingerprint SDK for the event. For example: `com.foo.app`|[optional]|
23
+
|**packageName**|**String**| Package name of the Android application integrated with the Fingerprint SDK for the event. For example: `com.foo.app`|[optional]|
24
24
|**ipAddress**|**String**| IP address of the requesting browser or bot. |[optional]|
25
-
|**userAgent**|**String**| User Agent of the client, for example: `Mozilla/5.0 (Windows NT 6.1; Win64; x64) ....`|[optional]|
26
-
|**clientReferrer**|**String**| Client Referrer field corresponds to the `document.referrer` field gathered during an identification request. The value is an empty string if the user navigated to the page directly (not through a link, but, for example, by using a bookmark) For example: `https://example.com/blog/my-article`|[optional]|
25
+
|**userAgent**|**String**| User Agent of the client, for example: `Mozilla/5.0 (Windows NT 6.1; Win64; x64) ....`|[optional]|
26
+
|**clientReferrer**|**String**| Client Referrer field corresponds to the `document.referrer` field gathered during an identification request. The value is an empty string if the user navigated to the page directly (not through a link, but, for example, by using a bookmark) For example: `https://example.com/blog/my-article`|[optional]|
|**clonedApp**|**Boolean**| Android specific cloned application detection. There are 2 values: * `true` - Presence of app cloners work detected (e.g. fully cloned application found or launch of it inside of a not main working profile detected). * `false` - No signs of cloned application detected or the client is not Android. |[optional]|
33
-
|**developerTools**|**Boolean**|`true` if the browser is Chrome with DevTools open or Firefox with Developer Tools open, `false` otherwise. |[optional]|
34
-
|**emulator**|**Boolean**| Android specific emulator detection. There are 2 values: * `true` - Emulated environment detected (e.g. launch inside of AVD). * `false` - No signs of emulated environment detected or the client is not Android. |[optional]|
32
+
|**clonedApp**|**Boolean**| Android specific cloned application detection. There are 2 values: * `true` - Presence of app cloners work detected (e.g. fully cloned application found or launch of it inside of a not main working profile detected). * `false` - No signs of cloned application detected or the client is not Android. |[optional]|
33
+
|**developerTools**|**Boolean**|`true` if the browser is Chrome with DevTools open or Firefox with Developer Tools open, `false` otherwise. |[optional]|
34
+
|**emulator**|**Boolean**| Android specific emulator detection. There are 2 values: * `true` - Emulated environment detected (e.g. launch inside of AVD). * `false` - No signs of emulated environment detected or the client is not Android. |[optional]|
35
35
|**factoryResetTimestamp**|**Long**| The time of the most recent factory reset that happened on the **mobile device** is expressed as Unix epoch time. When a factory reset cannot be detected on the mobile device or when the request is initiated from a browser, this field will correspond to the *epoch* time (i.e 1 Jan 1970 UTC) as a value of 0. See [Factory Reset Detection](https://dev.fingerprint.com/docs/smart-signals-overview#factory-reset-detection) to learn more about this Smart Signal. |[optional]|
36
-
|**frida**|**Boolean**|[Frida](https://frida.re/docs/) detection for Android and iOS devices. There are 2 values: * `true` - Frida detected * `false` - No signs of Frida or the client is not a mobile device. |[optional]|
36
+
|**frida**|**Boolean**|[Frida](https://frida.re/docs/) detection for Android and iOS devices. There are 2 values: * `true` - Frida detected * `false` - No signs of Frida or the client is not a mobile device. |[optional]|
|**incognito**|**Boolean**|`true` if we detected incognito mode used in the browser, `false` otherwise. |[optional]|
43
-
|**jailbroken**|**Boolean**| iOS specific jailbreak detection. There are 2 values: * `true` - Jailbreak detected. * `false` - No signs of jailbreak or the client is not iOS. |[optional]|
42
+
|**incognito**|**Boolean**|`true` if we detected incognito mode used in the browser, `false` otherwise. |[optional]|
43
+
|**jailbroken**|**Boolean**| iOS specific jailbreak detection. There are 2 values: * `true` - Jailbreak detected. * `false` - No signs of jailbreak or the client is not iOS. |[optional]|
44
44
|**locationSpoofing**|**Boolean**| Flag indicating whether the request came from a mobile device with location spoofing enabled. |[optional]|
45
-
|**mitmAttack**|**Boolean**| * `true` - When requests made from your users' mobile devices to Fingerprint servers have been intercepted and potentially modified. * `false` - Otherwise or when the request originated from a browser. See [MitM Attack Detection](https://dev.fingerprint.com/docs/smart-signals-reference#mitm-attack-detection) to learn more about this Smart Signal. |[optional]|
46
-
|**privacySettings**|**Boolean**|`true` if the request is from a privacy aware browser (e.g. Tor) or from a browser in which fingerprinting is blocked. Otherwise `false`. |[optional]|
47
-
|**rootApps**|**Boolean**| Android specific root management apps detection. There are 2 values: * `true` - Root Management Apps detected (e.g. Magisk). * `false` - No Root Management Apps detected or the client isn't Android. |[optional]|
45
+
|**mitmAttack**|**Boolean**| * `true` - When requests made from your users' mobile devices to Fingerprint servers have been intercepted and potentially modified. * `false` - Otherwise or when the request originated from a browser. See [MitM Attack Detection](https://dev.fingerprint.com/docs/smart-signals-reference#mitm-attack-detection) to learn more about this Smart Signal. |[optional]|
46
+
|**privacySettings**|**Boolean**|`true` if the request is from a privacy aware browser (e.g. Tor) or from a browser in which fingerprinting is blocked. Otherwise `false`. |[optional]|
47
+
|**rootApps**|**Boolean**| Android specific root management apps detection. There are 2 values: * `true` - Root Management Apps detected (e.g. Magisk). * `false` - No Root Management Apps detected or the client isn't Android. |[optional]|
|**suspectScore**|**Integer**| Suspect Score is an easy way to integrate Smart Signals into your fraud protection work flow. It is a weighted representation of all Smart Signals present in the payload that helps identify suspicious activity. The value range is [0; S] where S is sum of all Smart Signals weights. See more details here: https://dev.fingerprint.com/docs/suspect-score|[optional]|
50
-
|**tampering**|**Boolean**| Flag indicating browser tampering was detected. This happens when either: * There are inconsistencies in the browser configuration that cross internal tampering thresholds (see `tampering_details.anomaly_score`). * The browser signature resembles an \"anti-detect\" browser specifically designed to evade fingerprinting (see `tampering_details.anti_detect_browser`). |[optional]|
50
+
|**tampering**|**Boolean**| Flag indicating browser tampering was detected. This happens when either: * There are inconsistencies in the browser configuration that cross internal tampering thresholds (see `tampering_details.anomaly_score`). * The browser signature resembles an \"anti-detect\" browser specifically designed to evade fingerprinting (see `tampering_details.anti_detect_browser`). |[optional]|
|**virtualMachine**|**Boolean**|`true` if the request came from a browser running inside a virtual machine (e.g. VMWare), `false` otherwise. |[optional]|
53
+
|**virtualMachine**|**Boolean**|`true` if the request came from a browser running inside a virtual machine (e.g. VMWare), `false` otherwise. |[optional]|
54
54
|**vpn**|**Boolean**| VPN or other anonymizing service has been used when sending the request. |[optional]|
55
55
|**vpnConfidence**|**VpnConfidence**||[optional]|
56
56
|**vpnOriginTimezone**|**String**| Local timezone which is used in timezone_mismatch method. |[optional]|
57
-
|**vpnOriginCountry**|**String**| Country of the request (only for Android SDK version >= 2.4.0, ISO 3166 format or unknown). |[optional]|
57
+
|**vpnOriginCountry**|**String**| Country of the request (only for Android SDK version >= 2.4.0, ISO 3166 format or unknown). |[optional]|
|**paginationKey**|**String**| Use this value in the `pagination_key` parameter to request the next page of search results. |[optional]|
13
-
|**totalHits**|**Long**| This value represents the total number of events matching the search query, up to the limit provided in the `total_hits` query parameter. Only present if the `total_hits` query parameter was provided. |[optional]|
12
+
|**paginationKey**|**String**| Use this value in the `pagination_key` parameter to request the next page of search results. |[optional]|
13
+
|**totalHits**|**Long**| This value represents the total number of events matching the search query, up to the limit provided in the `total_hits` query parameter. Only present if the `total_hits` query parameter was provided. |[optional]|
|**visitorFound**|**Boolean**| Attribute represents if a visitor had been identified before. ||
13
-
|**firstSeenAt**|**Long**| Unix epoch time milliseconds timestamp indicating the time at which this visitor ID was first seen. example: `1758069706642` - Corresponding to Wed Sep 17 2025 00:41:46 GMT+0000 |[optional]|
14
-
|**lastSeenAt**|**Long**| Unix epoch time milliseconds timestamp indicating the time at which this visitor ID was last seen. example: `1758069706642` - Corresponding to Wed Sep 17 2025 00:41:46 GMT+0000 |[optional]|
13
+
|**firstSeenAt**|**Long**| Unix epoch time milliseconds timestamp indicating the time at which this visitor ID was first seen. example: `1758069706642` - Corresponding to Wed Sep 17 2025 00:41:46 GMT+0000 |[optional]|
14
+
|**lastSeenAt**|**Long**| Unix epoch time milliseconds timestamp indicating the time at which this visitor ID was last seen. example: `1758069706642` - Corresponding to Wed Sep 17 2025 00:41:46 GMT+0000 |[optional]|
0 commit comments