Sign in

v1

latestOpenAPI 3.0.02026-07-224019.9 KB

Retrieve data for a specific session

Get the risk score, risk explanation, biometric checks, and device checks for a specific session ID. The user_logs field is also included for backward compatibility but is deprecated — use the /v1/sessions/{sessionId}/events endpoint to retrieve a session's event log.

get/v1/sessions/{sessionId}/report

Path parameters

sessionIdstring required

The unique session identifier (from window.getRoundtableSessionId())

Response

Session data retrieved successfully

session_idstring

Unique identifier for the session

user_idstring

User identifier provided during script initialization (if any)

tagsstring[]

Tags associated with this session

risk_scoreinteger

Overall risk score for the session (0-100). Higher scores indicate higher risk.

risk_explanationstring

Short explanation of the factors contributing to the risk score

recommended_action'Auto-accept' | 'Accept with monitoring' | 'Manual review or require additional verification' | 'Auto-reject or high-priority review' | 'Unknown'

Suggested action based on the risk score

Example response

{
  "session_id": "abc123def456",
  "user_id": "user-456",
  "tags": [
    "intake-survey",
    "checkout-flow"
  ],
  "risk_score": 75,
  "risk_explanation": "User was flagged for multiple likely bot behaviors, indicating a medium to high risk of fraud.",
  "recommended_action": "Manual review or require additional verification",
  "user_logs": [
    {
      "action": "Signed in",
      "user_time": "Mar 25, 2025 14:30:45",
      "unix_timestamp": 1743055845000
    },
    {
      "action": "Navigated to /dashboard",
      "user_time": "Mar 25, 2025 14:30:50",
      "unix_timestamp": 1743055850000
    },
    {
      "action": "Updated credit card",
      "user_time": "Mar 25, 2025 14:32:15",
      "unix_timestamp": 1743055935000
    }
  ],
  "biometric_checks": {
    "agent_behavior": "Not detected",
    "programmatic_typing": "Detected",
    "teleporting_mouse": "Not detected",
    "no_corrections": "Detected",
    "all_pasted": "Unknown",
    "jump_scrolling": "Detected",
    "centered_clicks": "Detected",
    "programmatic_clicking": "Not detected",
    "external_input": "Not detected"
  },
  "device_checks": {
    "bot": "Detected",
    "virtual_machine": "Not detected",
    "software_renderer": "Not detected",
    "vpn": "Detected",
    "tor": "Not detected",
    "location_spoofing": "Unknown"
  }
}