Data Schema
This section contains a reference to a full list of parameters returned by Trustfull, in the Session Solution
For more information about this solution, see the Guide section here: Session Solution Guide
SESSION SIGNALS
| Name | Type | Description |
|---|---|---|
| score | `integer` | A number ranging from 0 to 1000 that represents the quality score of the session Ex: 649 |
| score_cluster | `string` | A cluster categorization that summarizes the quality score of the session Ex: high Enum: very_low, low, review, high, very_high |
| transaction_id | `string` | Unique identifier for the transaction Ex: 158db860-67e6-4ef7-8162-1a23a5e16cf5 |
| session_id | `string` | Session identifier for the login interaction Ex: session-123 |
| device_request_time | `string` | The timestamp of the request from the device Ex: 2024-12-12T10:00:00Z |
| app_key | `string` | The application key associated with the request Ex: TFB-abc |
| ips | `string` | List of IP addresses associated with the session Ex: 1.1.1.1,2.2.2.2 |
| header_user_agent | `string` | The User Agent sent by headers Ex: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36 |
| header_language | `string` | The Language sent by headers Ex: en-US,en;q=0.9,it;q=0.8 |
| header_referer | `string` | The Referer sent by headers Ex: https://trustfull.com/ |
| header_mime_types | `string` | The MimeType sent by headers Ex: image/avif,image/webp,image/apng,image/svg+xml,image/,/*;q=0.8 |
| navigator_user_agent | `string` | The User Agent detected by the SDK Ex: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36 |
| navigator_language | `string` | The Language detected by the SDK Ex: en-US,en;q=0.9,it;q=0.8 |
| navigator_platform | `string` | The OS detected by the SDK Ex: Linux x86_64 |
| navigator_plugins | `string` | The list of plugins detected by the SDK Ex: PDF Viewer,Chrome PDF Viewer |
| navigator_mime_types | `string` | The MimeType detected by the SDK Ex: application/pdf,text/pdf |
| navigator_app_version | `string` | The browser version detected by the SDK Ex: 5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36 |
| navigator_web_driver | `boolean` | Indicates if a webdriver has been detected Ex: false |
| navigator_connection_rtt | `integer` | The timing of RTT connection detected by the SDK Ex: 50 |
| window_outer_height | `integer` | The outer height of the window Ex: 960 |
| window_outer_width | `integer` | The outer width of the window Ex: 1280 |
| window_resolution | `string` | The window resolution Ex: 1280x960 |
| viewport_resolution | `string` | The viewport resolution Ex: 1280x960 |
| has_mime_prototype_anomaly | `boolean` | Indicates if the SDK detected a mimetype anomaly Ex: false |
| has_permissions_anomaly | `boolean` | Indicates if the SDK detected a permission anomaly Ex: false |
| has_plugins_prototype_anomaly | `boolean` | Indicates if the SDK detected a plugins anomaly Ex: false |
| has_puppeteer_extra_stealth | `boolean` | Indicates if the SDK detected the extra-stealth puppetter plugin Ex: false |
| mouse_movement | `integer` | The number of mouse movements within the browser Ex: 10 |
| zero_movement_count | `integer` | The number of anomaly mouse movements Ex: 10 |
| total_movements | `integer` | The total number of mouse movements Ex: 10 |
| click_count | `integer` | The number of mouse clicks on page Ex: 10 |
| wheel_count | `integer` | The number of mouse scroll events Ex: 10 |
| time_elapsed_ms | `integer` | The delay between the page load event and the trigger of the SDK Ex: 11000 |
| has_headless_app_version | `boolean` | Indicates if an headless app version has been detected Ex: true |
| has_headless_user_agent | `boolean` | Indicates if an headless user agent has been detected Ex: true |
| user_agent_match | `boolean` | Indicates if there's a match with user agents detected Ex: true |
| language_match | `boolean` | Indicates if there's a match with languages detected Ex: true |
| mime_types_match | `boolean` | Indicates if there's a match with mime types detected Ex: true |
| has_window_outer_dimension_anomaly | `boolean` | Indicates if we detected an anomaly about window dimensions Ex: true |
| battery_charging | `boolean` | Indicates if a charging battery has been detected Ex: true |
| battery_level | `integer` | The battery level of the device Ex: 92 |
| navigator_browser_name | `string` | The browser name detected from the navigator Ex: Chrome |
| navigator_browser_version | `string` | The browser version detected from the navigator Ex: 138.0.0.0 |
| navigator_type | `string` | The type of the navigator Ex: Desktop |
| navigator_brand | `string` | The brand of the navigator Ex: Apple |
| navigator_model | `string` | The model of the navigator Ex: Generic Android Mobile |
| mobile_phone_is_too_generic | `boolean` | A flag indicating whether the combination of navigator type, brand, model and operative system refers to a too generic device. Ex: true |
| navigator_model_commercial | `string` | The commercial model of the navigator Ex: iPhone 7 |
| navigator_operating_system | `string` | The operating system of the navigator Ex: Windows 10 |
| timezone | `string` | The timezone detected Ex: Europe/Rome |
| video_card_has_gl | `boolean` | Indicates if the GL extensions has been detected from the video card Ex: true |
| video_card_has_extension | `boolean` | Indicates if extensions has been detected from the video card Ex: true |
| video_card_renderer | `string` | The video card renderer Ex: angle (apple, angle metal renderer: apple m3 pro, unspecified version) |
| video_card_vendor | `string` | The video card vendor Ex: google inc. (apple) |
| has_ai_agent | `boolean` | If an AI agent has been detected Ex: true |
| has_automated_browser | `boolean` | If a browser automation has been detected Ex: true |
| has_spoofed_device | `boolean` | If a device spoofing has been detected Ex: true |
| has_suspicious_resolution | `boolean` | If a suspicious resolution has been detected Ex: true |
| has_valid_video_card | `boolean` | If a valid video card has been detected Ex: true |
| window_viewport_dimension_match | `boolean` | If there is a match between the viewport and the window Ex: true |
| font_list | `string` | The list of fonts detected Ex: ["Arial","Verdana","Times New Roman"] |
| supported_bluetooth | `boolean` | Indicates if the bluetooth is supported Ex: true |
| navigator_connection_effective_type | `string` | The connection type of the navigator Ex: 4g |
| navigator_connection_downlink | `integer` | The detected effective bandwidth estimate in megabits per second Ex: 10 |
| navigator_device_memory | `integer` | The detected memory in gigabytes of the navigator Ex: 10 |
| navigator_hardware_concurrency | `integer` | The detected number of logical processors Ex: 10 |
| navigator_max_touch_points | `integer` | The detected the maximum number of simultaneous touch contact points Ex: 10 |
| navigator_platform_version | `string` | The detected platform version Ex: 10.0.0 |
| font_detected_os | `string` | The OS inferred by installed fonts Ex: Windows |
| font_detected_os_prediction_probability | `number` | The probability of OS inferred by installed fonts Ex: Windows |
| font_detected_os_probabilities | `string` | A JSON containing the probabilities of each possible OS predicted using installed fonts Ex: Windows |
| media_type_detected_browser | `string` | The browser inferred by supported media types Ex: Windows |
| media_type_detected_browser_prediction_probability | `number` | The probability of browser inferred by supported media types Ex: Windows |
| media_type_detected_browser_probabilities | `string` | A JSON containing the probabilities of each possible browser predictable by supported media type Ex: Windows |
| permissions_detected_browser | `string` | The browser inferred by permissions settings Ex: Windows |
| permissions_detected_browser_prediction_probability | `number` | The probability of browser inferred by permissions settings Ex: Windows |
| permissions_detected_browser_probabilities | `string` | A JSON containing the probabilities of each possible browser predictable by supported media type Ex: Windows |
| detected_os_platform_match | `boolean` | Indicates if the detected platform matches Ex: true |
| detected_os_user_agent_match | `boolean` | Indicates if the detected OS matches Ex: true |
| detected_browser_name | `string` | The browser name detected by multiple signals Ex: Chrome |
| detected_browser_name_match | `boolean` | Indicates if the detected browser name navigator and detected browser name matches Ex: true |
| ai_agent_name | `string` | The name of the detected AI agent Ex: ChatGPT |
| ip | `string` | IP address of the login event Ex: 192.168.0.1 |
| ip_black_list_count | `integer` | The number of providers that have flagged this IP as spam Ex: 5 |
| ip_city | `string` | City associated with the IP address Ex: New York |
| ip_company_domain | `string` | The name of the domain of the company that owns the domain, if found Ex: google.com |
| ip_connection_speed | `string` | Internet connection speed associated to the ip address: - company/T1 - broadband/cable/fiber - mobile Ex: company/T1 Enum: company/T1, broadband/cable/fiber, mobile |
| ip_connection_type | `string` | Usage type classification of ISP or company: - Commercial - Content Delivery Network - Fixed Line - Mobile ISP - Reserved - University / College / School Ex: Reserved Enum: Commercial, Content Delivery Network, Fixed Line, Mobile ISP, Reserved, University / College / School |
| ip_country | `string` | Country name associated with the IP address Ex: United States |
| ip_country_code | `string` | Country associated with the IP address, ISO 3166 alpha-2 Ex: US |
| ip_css_count | `integer` | The number of times this IP address has been reported in a Combined Spam Sources (CSS) Ex: 3 |
| ip_css_in_days | `integer` | The how many days has passed since the most recent report in a Exploits Blocklist (XBL). Recency indicates more accurate data. Ex: 7 |
| ip_is_hosting | `boolean` | Indicates if the IP address is an hosting provider Ex: true |
| ip_is_mobile | `boolean` | Indicates if the IP address is associated with a mobile connection Ex: false |
| ip_isp | `string` | Internet service provider associated with the IP address Ex: Comcast |
| ip_is_proxy | `boolean` | Indicates if the IP address is a proxy Ex: false |
| ip_is_relay | `boolean` | Indicates if the IP address is a relay Ex: false |
| ip_is_tor | `boolean` | Indicates if the IP address is part of the Tor network Ex: false |
| ip_is_valid_format | `boolean` | Indicates if the IP address is in a valid format Ex: true |
| ip_is_vpn | `boolean` | Indicates if the IP address is associated with a VPN Ex: false |
| ip_lat | `string` | Latitude of the location associated with the IP address Ex: 40.7128 |
| ip_lon | `string` | Longitude of the location associated with the IP address Ex: -74.0060 |
| ip_proxy_name | `string` | Name of the proxy associated with the IP address, if any Ex: ProxyXYZ |
| ip_proxy_type | `string` | When the IP address is a Proxy, indicates the type of Proxy Ex: datacenter Enum: datacenter, residential |
| ip_timezone | `string` | The Timezone the IP address belongs to Ex: CET |
| ip_timezone_request_time | `string` | Time of the day the user is requesting your service Ex: night Enum: morning, afternoon, evening, night |
| ip_xbl_count | `integer` | The number of times this IP address has been reported in a Exploits Blocklist (XBL) Ex: 2 |
| ip_xbl_in_days | `integer` | The how many days has passed since the most recent report in a Exploits Blocklist (XBL). Recency indicates more accurate data. Ex: 2 |
| ip_zip | `string` | ZIP code associated with the IP address Ex: 10001 |
| has_suspicious_browser_timezone_format | `boolean` | When browser returns a non IANA Timezone it usually indicates a non standard environment or a manipulated browser. Ex: true |
| permissions_detected_browser_navigator_match | `boolean` | A flag indicating when the browser engine inferred from permissions matches with sessions metadata. Ex: true |
| media_type_detected_browser_navigator_match | `boolean` | A flag indicating when the browser engine inferred from media type matches with sessions metadata. Ex: true |
For more information about how to use the Session solution you can go to Session Solution Guide
Updated 3 days ago