v1

latestOpenAPI 3.0.02026-07-242235189.3 KB

Solutions

Trustfull Login (Score)

post/track/results

Query parameters

session-idstring

Headers

content-typestring

acceptstring

x-api-keystring required

Example:[your-api-key]

Response

transaction_idstring nullable

Unique identifier for the transaction

usernamestring nullable

The username associated with the session or transaction

app_keystring nullable

The application key associated with the request

session_idstring nullable

Session identifier for the login interaction

browser_battery_chargingboolean nullable

Indicates whether the battery is charging

browser_battery_levelinteger nullable

Current battery level as a percentage

browser_device_operating_systemstring nullable

Operating system of the device running the browser

browser_device_typestring nullable

Type of device running the browser (e.g., desktop, mobile)

browser_has_privacy_related_pluginsboolean nullable

Indicates whether the browser has privacy-related plugins installed

browser_namestring nullable

Name of the browser being used

browser_languagestring nullable

Language of the browser, in the standard RFC 9110

browser_timezonestring nullable

Timezon of the browser, in the standard IANA Time Zone Database

browser_versionstring nullable

Version of the browser being used

browser_cpu_classstring nullable

CPU Architecture

browser_cpu_coresinteger nullable

Number of the cores of the CPU

browser_video_card_vendorstring nullable

The vendor of the CPU

browser_video_card_rendererstring nullable

The CPU render engine

browser_media_devices_countinteger nullable

The count of media device

browser_media_devices_liststring nullable

The list of media device

browser_screen_resolutionstring nullable

The resolution of the browser

browser_viewportstring nullable

The viewport of the browser

browser_color_depthinteger nullable

The browser color depth

browser_cookies_enabledboolean nullable

Indicates if the browser has cookies enabled

browser_incognito_modeboolean nullable

Indicates if the browser is in incognito mode

device_request_timestring nullable

The timestamp of the request from the device

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

browser_device_modelstring nullable

Device model running the browser

browser_device_brandstring nullable

Brand of the device running the browser

ip_vpn_namestring nullable

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

scoreinteger nullable

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

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

A cluster categorization that summarizes the quality score of the login

Example response

{
  "transaction_id": "158db860-67e6-4ef7-8162-1a23a5e16cf5",
  "username": "johndoe",
  "app_key": "TFB-abc",
  "session_id": "session-123",
  "browser_battery_charging": true,
  "browser_battery_level": 85,
  "browser_device_operating_system": "Android",
  "browser_device_type": "desktop",
  "browser_has_privacy_related_plugins": true,
  "browser_name": "Chrome",
  "browser_language": "en-US",
  "browser_timezone": "America/New_York",
  "browser_version": "114.0.1",
  "browser_cpu_class": "x86",
  "browser_video_card_vendor": "google inc. (intel)",
  "browser_video_card_renderer": "angle (intel, mesa intel(r) graphics (rpl-u), opengl 4.6)",
  "browser_media_devices_list": "audioinput,videoinput,audiooutput",
  "browser_screen_resolution": "1920x1080",
  "browser_viewport": "1193x1327",
  "browser_cookies_enabled": true,
  "browser_incognito_mode": true,
  "device_request_time": "2024-12-12T10:00:00Z",
  "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",
  "browser_device_model": "Galaxy S7 Edge",
  "browser_device_brand": "Samsung",
  "ip_vpn_name": "NordVPN",
  "score": 649,
  "score_cluster": "high"
}