Getting Started
Set up
Developer Resources
curl --request GET \
--url https://api.roundtable.ai/v1/users/{userId}/sessions \
--header 'Authorization: Bearer <token>'{
"user_id": "user-456",
"sessions": [
{
"session_id": "abc123def456",
"risk_score": 75,
"risk_explanation": "Multiple bot behaviors detected including programmatic typing and lack of corrections",
"user_logs": [
{
"action": "Navigated to /dashboard",
"user_time": "Mar 25, 2025 14:30:50",
"unix_timestamp": 1743055850000
}
],
"biometric_checks": {
"programmatic_typing": "Detected",
"teleporting_mouse": "Not detected",
"no_corrections": "Detected",
"all_pasted": "Unknown"
},
"device_checks": {
"bot": "Detected",
"virtual_machine": "Not detected",
"vpn": "Detected",
"tor": "Not detected",
"location_spoofing": "Unknown"
}
}
]
}Getting User Data
Get the 100 most recent sessions for a specific user ID
curl --request GET \
--url https://api.roundtable.ai/v1/users/{userId}/sessions \
--header 'Authorization: Bearer <token>'{
"user_id": "user-456",
"sessions": [
{
"session_id": "abc123def456",
"risk_score": 75,
"risk_explanation": "Multiple bot behaviors detected including programmatic typing and lack of corrections",
"user_logs": [
{
"action": "Navigated to /dashboard",
"user_time": "Mar 25, 2025 14:30:50",
"unix_timestamp": 1743055850000
}
],
"biometric_checks": {
"programmatic_typing": "Detected",
"teleporting_mouse": "Not detected",
"no_corrections": "Detected",
"all_pasted": "Unknown"
},
"device_checks": {
"bot": "Detected",
"virtual_machine": "Not detected",
"vpn": "Detected",
"tor": "Not detected",
"location_spoofing": "Unknown"
}
}
]
}Authorizations
Use your secret API key as the bearer token
Path Parameters
The unique user identifier
Response
User sessions retrieved successfully
The user identifier
"user-456"
List of session data
Show child attributes
Show child attributes
Unique identifier for the session
"abc123def456"
Overall risk assessment score for the session (0-100)
0 <= x <= 10075
Short explanation of the factors contributing to the risk score
"Multiple bot behaviors detected including programmatic typing and lack of corrections"
Chronological list of user actions recorded during the session
Show child attributes
Show child attributes
Description of the user action
"Navigated to /dashboard"
Human-readable timestamp in user's local timezone
"Mar 25, 2025 14:30:50"
Unix timestamp in milliseconds
1743055850000
Results of biometric analysis for bot detection
Show child attributes
Show child attributes
User had highly regular typing patterns typical of programmatic input
Detected, Not detected, Unknown "Detected"
User moved the mouse cursor to different page locations without transition
Detected, Not detected, Unknown "Not detected"
User made text entries without any corrections or backspaces
Detected, Not detected, Unknown "Detected"
All text responses were pasted rather than typed by the user
Detected, Not detected, Unknown "Unknown"
{
"programmatic_typing": "Detected",
"teleporting_mouse": "Not detected",
"no_corrections": "Detected",
"all_pasted": "Unknown"
}Results of device and network checks for environment anomalies
Show child attributes
Show child attributes
Browser execution context indicates an automated tool (e.g. Selenium or Playwright)
Detected, Not detected, Unknown "Detected"
Signals show the browser is running inside a virtual machine or sandbox
Detected, Not detected, Unknown "Not detected"
IP address belongs to a known VPN or hosting provider
Detected, Not detected, Unknown "Detected"
Connection is routed through a Tor exit node
Detected, Not detected, Unknown "Not detected"
Browser-reported geolocation conflicts with IP-based location or appears simulated
Detected, Not detected, Unknown "Unknown"
{
"bot": "Detected",
"virtual_machine": "Not detected",
"vpn": "Detected",
"tor": "Not detected",
"location_spoofing": "Unknown"
}