v1

latestOpenAPI 3.0.02026-07-242235189.3 KB

Solutions

Trustfull Session

get/session/result/{sessionId}

Path parameters

sessionIdstring required

Example:session_id_393494108457

Headers

content-typestring

acceptstring

x-api-keystring required

Example:[your-api-key]

Response

scoreinteger nullable

A number ranging from 0 to 1000 that represents the quality score of the session

score_cluster'very_low' | 'low' | 'review' | 'high' | 'very_high' nullable

A cluster categorization that summarizes the quality score of the session

transaction_idstring nullable

Unique identifier for the transaction

session_idstring nullable

Session identifier for the login interaction

device_request_timestring nullable

The timestamp of the request from the device

app_keystring nullable

The application key associated with the request

ipsstring nullable

List of IP addresses associated with the session

header_user_agentstring nullable

The User Agent sent by headers

header_languagestring nullable

The Language sent by headers

header_refererstring nullable

The Referer sent by headers

header_mime_typesstring nullable

The MimeType sent by headers

navigator_user_agentstring nullable

The User Agent detected by the SDK

navigator_languagestring nullable

The Language detected by the SDK

navigator_platformstring nullable

The OS detected by the SDK

navigator_pluginsstring nullable

The list of plugins detected by the SDK

navigator_mime_typesstring nullable

The MimeType detected by the SDK

navigator_app_versionstring nullable

The browser version detected by the SDK

navigator_web_driverboolean nullable

Indicates if a webdriver has been detected

navigator_connection_rttinteger nullable

The timing of RTT connection detected by the SDK

window_outer_heightinteger nullable

The outer height of the window

window_outer_widthinteger nullable

The outer width of the window

window_resolutionstring nullable

The window resolution

viewport_resolutionstring nullable

The viewport resolution

has_mime_prototype_anomalyboolean nullable

Indicates if the SDK detected a mimetype anomaly

has_permissions_anomalyboolean nullable

Indicates if the SDK detected a permission anomaly

has_plugins_prototype_anomalyboolean nullable

Indicates if the SDK detected a plugins anomaly

has_puppeteer_extra_stealthboolean nullable

Indicates if the SDK detected the extra-stealth puppetter plugin

mouse_movementinteger nullable

The number of mouse movements within the browser

zero_movement_countinteger nullable

The number of anomaly mouse movements

total_movementsinteger nullable

The total number of mouse movements

click_countinteger nullable

The number of mouse clicks on page

wheel_countinteger nullable

The number of mouse scroll events

time_elapsed_msinteger nullable

The delay between the page load event and the trigger of the SDK

has_headless_app_versionboolean nullable

Indicates if an headless app version has been detected

has_headless_user_agentboolean nullable

Indicates if an headless user agent has been detected

user_agent_matchboolean nullable

Indicates if there's a match with user agents detected

language_matchboolean nullable

Indicates if there's a match with languages detected

mime_types_matchboolean nullable

Indicates if there's a match with mime types detected

has_window_outer_dimension_anomalyboolean nullable

Indicates if we detected an anomaly about window dimensions

battery_chargingboolean nullable

Indicates if a charging battery has been detected

battery_levelinteger nullable

The battery level of the device

navigator_browser_namestring nullable

The browser name detected from the navigator

navigator_browser_versionstring nullable

The browser version detected from the navigator

navigator_typestring nullable

The type of the navigator

navigator_brandstring nullable

The brand of the navigator

navigator_modelstring nullable

The model of the navigator

mobile_phone_is_too_genericboolean nullable

A flag indicating whether the combination of navigator type, brand, model and operative system refers to a too generic device.

navigator_model_commercialstring nullable

The commercial model of the navigator

navigator_operating_systemstring nullable

The operating system of the navigator

timezonestring nullable

The timezone detected

video_card_has_glboolean nullable

Indicates if the GL extensions has been detected from the video card

video_card_has_extensionboolean nullable

Indicates if extensions has been detected from the video card

video_card_rendererstring nullable

The video card renderer

video_card_vendorstring nullable

The video card vendor

has_ai_agentboolean nullable

If an AI agent has been detected

has_automated_browserboolean nullable

If a browser automation has been detected

has_spoofed_deviceboolean nullable

If a device spoofing has been detected

has_suspicious_resolutionboolean nullable

If a suspicious resolution has been detected

has_valid_video_cardboolean nullable

If a valid video card has been detected

window_viewport_dimension_matchboolean nullable

If there is a match between the viewport and the window

font_liststring nullable

The list of fonts detected

supported_bluetoothboolean nullable

Indicates if the bluetooth is supported

navigator_connection_effective_typestring nullable

The connection type of the navigator

navigator_connection_downlinkinteger nullable

The detected effective bandwidth estimate in megabits per second

navigator_device_memoryinteger nullable

The detected memory in gigabytes of the navigator

navigator_hardware_concurrencyinteger nullable

The detected number of logical processors

navigator_max_touch_pointsinteger nullable

The detected the maximum number of simultaneous touch contact points

navigator_platform_versionstring nullable

The detected platform version

font_detected_osstring nullable

The OS inferred by installed fonts

font_detected_os_prediction_probabilitynumber float nullable

The probability of OS inferred by installed fonts

font_detected_os_probabilitiesstring nullable

A JSON containing the probabilities of each possible OS predicted using installed fonts

media_type_detected_browserstring nullable

The browser inferred by supported media types

media_type_detected_browser_prediction_probabilitynumber float nullable

The probability of browser inferred by supported media types

media_type_detected_browser_probabilitiesstring nullable

A JSON containing the probabilities of each possible browser predictable by supported media type

permissions_detected_browserstring nullable

The browser inferred by permissions settings

permissions_detected_browser_prediction_probabilitynumber float nullable

The probability of browser inferred by permissions settings

permissions_detected_browser_probabilitiesstring nullable

A JSON containing the probabilities of each possible browser predictable by supported media type

detected_os_platform_matchboolean nullable

Indicates if the detected platform matches

detected_os_user_agent_matchboolean nullable

Indicates if the detected OS matches

detected_browser_namestring nullable

The browser name detected by multiple signals

detected_browser_name_matchboolean nullable

Indicates if the detected browser name navigator and detected browser name matches

ai_agent_namestring nullable

The name of the detected AI agent

ipstring nullable

IP address of the login event

ip_black_list_countinteger nullable

The number of providers that have flagged this IP as spam

ip_citystring nullable

City associated with the IP address

ip_company_domainstring nullable

The name of the domain of the company that owns the domain, if found

ip_connection_speed'company/T1' | 'broadband/cable/fiber' | 'mobile' nullable

Internet connection speed associated to the ip address: - company/T1 - broadband/cable/fiber - mobile

Usage type classification of ISP or company: - Commercial - Content Delivery Network - Fixed Line - Mobile ISP - Reserved - University / College / School

ip_countrystring nullable

Country name associated with the IP address

ip_country_codestring nullable

Country associated with the IP address, ISO 3166 alpha-2

ip_css_countinteger nullable

The number of times this IP address has been reported in a Combined Spam Sources (CSS)

ip_css_in_daysinteger nullable

The how many days has passed since the most recent report in a Exploits Blocklist (XBL). Recency indicates more accurate data.

ip_is_hostingboolean nullable

Indicates if the IP address is an hosting provider

ip_is_mobileboolean nullable

Indicates if the IP address is associated with a mobile connection

ip_ispstring nullable

Internet service provider associated with the IP address

ip_is_proxyboolean nullable

Indicates if the IP address is a proxy

ip_is_relayboolean nullable

Indicates if the IP address is a relay

ip_is_torboolean nullable

Indicates if the IP address is part of the Tor network

ip_is_valid_formatboolean nullable

Indicates if the IP address is in a valid format

ip_is_vpnboolean nullable

Indicates if the IP address is associated with a VPN

ip_latstring nullable

Latitude of the location associated with the IP address

ip_lonstring nullable

Longitude of the location associated with the IP address

ip_proxy_namestring nullable

Name of the proxy associated with the IP address, if any

ip_proxy_type'datacenter' | 'residential' nullable

When the IP address is a Proxy, indicates the type of Proxy

ip_timezonestring nullable

The Timezone the IP address belongs to

ip_timezone_request_time'morning' | 'afternoon' | 'evening' | 'night' nullable

Time of the day the user is requesting your service

ip_xbl_countinteger nullable

The number of times this IP address has been reported in a Exploits Blocklist (XBL)

ip_xbl_in_daysinteger nullable

The how many days has passed since the most recent report in a Exploits Blocklist (XBL). Recency indicates more accurate data.

ip_zipstring nullable

ZIP code associated with the IP address

has_suspicious_browser_timezone_formatboolean nullable

When browser returns a non IANA Timezone it usually indicates a non standard environment or a manipulated browser.

permissions_detected_browser_navigator_matchboolean nullable

A flag indicating when the browser engine inferred from permissions matches with sessions metadata.

media_type_detected_browser_navigator_matchboolean nullable

A flag indicating when the browser engine inferred from media type matches with sessions metadata.

Example response

{
  "score": 649,
  "score_cluster": "high",
  "transaction_id": "158db860-67e6-4ef7-8162-1a23a5e16cf5",
  "session_id": "session-123",
  "device_request_time": "2024-12-12T10:00:00Z",
  "app_key": "TFB-abc",
  "ips": "1.1.1.1,2.2.2.2",
  "header_user_agent": "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": "en-US,en;q=0.9,it;q=0.8",
  "header_referer": "https://trustfull.com/",
  "header_mime_types": "image/avif,image/webp,image/apng,image/svg+xml,image/*,*/*;q=0.8",
  "navigator_user_agent": "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": "en-US,en;q=0.9,it;q=0.8",
  "navigator_platform": "Linux x86_64",
  "navigator_plugins": "PDF Viewer,Chrome PDF Viewer",
  "navigator_mime_types": "application/pdf,text/pdf",
  "navigator_app_version": "5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36",
  "window_resolution": "1280x960",
  "viewport_resolution": "1280x960",
  "navigator_browser_name": "Chrome",
  "navigator_browser_version": "138.0.0.0",
  "navigator_type": "Desktop",
  "navigator_brand": "Apple",
  "navigator_model": "Generic Android Mobile",
  "navigator_model_commercial": "iPhone 7",
  "navigator_operating_system": "Windows 10",
  "timezone": "Europe/Rome",
  "video_card_renderer": "angle (apple, angle metal renderer: apple m3 pro, unspecified version)",
  "video_card_vendor": "google inc. (apple)",
  "font_list": "[\"Arial\",\"Verdana\",\"Times New Roman\"]",
  "navigator_connection_effective_type": "4g",
  "navigator_platform_version": "10.0.0",
  "font_detected_os": "Windows",
  "font_detected_os_probabilities": "Windows",
  "media_type_detected_browser": "Windows",
  "media_type_detected_browser_probabilities": "Windows",
  "permissions_detected_browser": "Windows",
  "permissions_detected_browser_probabilities": "Windows",
  "detected_browser_name": "Chrome",
  "ai_agent_name": "ChatGPT",
  "ip": "192.168.0.1",
  "ip_black_list_count": 5,
  "ip_city": "New York",
  "ip_company_domain": "google.com",
  "ip_connection_speed": "company/T1",
  "ip_connection_type": "Reserved",
  "ip_country": "United States",
  "ip_country_code": "US",
  "ip_css_count": 3,
  "ip_css_in_days": 7,
  "ip_is_hosting": true,
  "ip_isp": "Comcast",
  "ip_is_valid_format": true,
  "ip_lat": "40.7128",
  "ip_lon": "-74.0060",
  "ip_proxy_name": "ProxyXYZ",
  "ip_proxy_type": "datacenter",
  "ip_timezone": "CET",
  "ip_timezone_request_time": "night",
  "ip_xbl_count": 2,
  "ip_xbl_in_days": 2,
  "ip_zip": "10001",
  "has_suspicious_browser_timezone_format": true,
  "permissions_detected_browser_navigator_match": true,
  "media_type_detected_browser_navigator_match": true
}