Getting Started
Developer Resources
Getting User Data
Get the 100 most recent sessions for a specific user ID, including user actions, failed checks, and session replay links for each session
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"
},
"replay_link": "https://app.roundtable.ai/replay/abc123def456"
}
]
}Authorizations
Use your secret API key as the bearer token
Path Parameters
The unique user identifier
Response
The user identifier
"user-456"
List of session data
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
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
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"
}
URL to view the session replay (will be null if replay is disabled)
"https://app.roundtable.ai/replay/abc123def456"
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"
},
"replay_link": "https://app.roundtable.ai/replay/abc123def456"
}
]
}