v1

latestOpenAPI 3.0.02026-07-224019.9 KB

Retrieve recent sessions for a specific user

Get the 100 most recent sessions for a specific user ID

get/v1/users/{userId}/sessions

Path parameters

userIdstring required

The unique user identifier

Response

User sessions retrieved successfully

user_idstring

The user identifier

Example response

{
  "user_id": "user-456",
  "sessions": [
    {
      "session_id": "abc123def456",
      "tags": [
        "intake-survey",
        "checkout-flow"
      ],
      "risk_score": 75,
      "risk_explanation": "Multiple bot behaviors detected including programmatic typing and lack of corrections",
      "recommended_action": "Manual review or require additional verification",
      "user_logs": [
        {
          "action": "Navigated to /dashboard",
          "user_time": "Mar 25, 2025 14:30:50",
          "unix_timestamp": 1743055850000
        }
      ],
      "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"
      }
    }
  ]
}