> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roundtable.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting User Data

> Get the 100 most recent sessions for a specific user ID



## OpenAPI

````yaml GET /v1/users/{userId}/sessions
openapi: 3.0.0
info:
  title: Roundtable API
  description: API for real-time bot detection
  version: v1
  contact:
    email: support@roundtable.ai
servers:
  - url: https://api.roundtable.ai
    description: Production API server
security:
  - BearerAuth: []
tags:
  - name: sessions
    description: Operations related to session data
  - name: users
    description: Operations related to user data
  - name: tags
    description: Operations related to tag data
externalDocs:
  description: Roundtable Documentation
  url: https://docs.roundtable.ai
paths:
  /v1/users/{userId}/sessions:
    get:
      summary: Retrieve recent sessions for a specific user
      description: Get the 100 most recent sessions for a specific user ID
      parameters:
        - name: userId
          in: path
          required: true
          schema:
            type: string
          description: The unique user identifier
      responses:
        '200':
          description: User sessions retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  user_id:
                    type: string
                    description: The user identifier
                    example: user-456
                  sessions:
                    type: array
                    description: List of session data
                    items:
                      type: object
                      properties:
                        session_id:
                          type: string
                          description: Unique identifier for the session
                          example: abc123def456
                        tags:
                          type: array
                          description: Tags associated with this session
                          items:
                            type: string
                          example:
                            - intake-survey
                            - checkout-flow
                        risk_score:
                          type: integer
                          minimum: 0
                          maximum: 100
                          description: >-
                            Overall risk assessment score for the session
                            (0-100)
                          example: 75
                        risk_explanation:
                          type: string
                          description: >-
                            Short explanation of the factors contributing to the
                            risk score
                          example: >-
                            Multiple bot behaviors detected including
                            programmatic typing and lack of corrections
                        recommended_action:
                          type: string
                          description: Suggested action based on the risk score
                          enum:
                            - Auto-accept
                            - Accept with monitoring
                            - Manual review or require additional verification
                            - Auto-reject or high-priority review
                            - Unknown
                          example: Manual review or require additional verification
                        user_logs:
                          type: array
                          deprecated: true
                          description: >-
                            **Deprecated.** Chronological list of user actions
                            recorded during the session. This field will be
                            removed soon — use the
                            [`/v1/sessions/{sessionId}/events`](/api-reference/events-data)
                            endpoint instead.
                          items:
                            type: object
                            properties:
                              action:
                                type: string
                                description: Description of the user action
                                example: Navigated to /dashboard
                              user_time:
                                type: string
                                description: >-
                                  Human-readable timestamp in user's local
                                  timezone
                                example: Mar 25, 2025 14:30:50
                              unix_timestamp:
                                type: integer
                                description: Unix timestamp in milliseconds
                                example: 1743055850000
                        biometric_checks:
                          type: object
                          description: Results of biometric analysis for bot detection
                          properties:
                            agent_behavior:
                              type: string
                              description: >-
                                ML model detected patterns across biometric data
                                consistent with automated behavior
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Not detected
                            programmatic_typing:
                              type: string
                              description: >-
                                User had highly regular typing patterns typical
                                of programmatic input
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Detected
                            teleporting_mouse:
                              type: string
                              description: >-
                                User moved the mouse cursor to different page
                                locations without transition
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Not detected
                            no_corrections:
                              type: string
                              description: >-
                                User made text entries without any corrections
                                or backspaces
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Detected
                            all_pasted:
                              type: string
                              description: >-
                                All text responses were pasted rather than typed
                                by the user
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Unknown
                            jump_scrolling:
                              type: string
                              description: >-
                                User scrolls in large jumps with no intermediate
                                or continuous scroll events
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Detected
                            centered_clicks:
                              type: string
                              description: >-
                                User made perfectly centered clicks with no
                                natural variation
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Detected
                            programmatic_clicking:
                              type: string
                              description: >-
                                User clicks were made programmatically rather
                                than through natural user interaction
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Not detected
                            external_input:
                              type: string
                              description: >-
                                User left the survey tab and pasted input after
                                returning
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Not detected
                          example:
                            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:
                          type: object
                          description: >-
                            Results of device and network checks for environment
                            anomalies
                          properties:
                            bot:
                              type: string
                              description: >-
                                Browser execution context indicates an automated
                                tool (e.g. Selenium or Playwright)
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Detected
                            virtual_machine:
                              type: string
                              description: >-
                                Signals suggest the browser is running in a
                                remote, virtualized, sandboxed, or
                                software-rendered environment
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Not detected
                            software_renderer:
                              type: string
                              description: >-
                                Browser is using a software-based graphics
                                renderer (e.g. SwiftShader or llvmpipe) instead
                                of hardware acceleration, which may suggest a
                                remote, virtualized, or headless browser
                                environment
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Not detected
                            vpn:
                              type: string
                              description: >-
                                IP address belongs to a known VPN or hosting
                                provider
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Detected
                            tor:
                              type: string
                              description: Connection is routed through a Tor exit node
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Not detected
                            location_spoofing:
                              type: string
                              description: >-
                                Browser-reported geolocation conflicts with
                                IP-based location or appears simulated
                              enum:
                                - Detected
                                - Not detected
                                - Unknown
                              example: Unknown
                          example:
                            bot: Detected
                            virtual_machine: Not detected
                            software_renderer: Not detected
                            vpn: Detected
                            tor: Not detected
                            location_spoofing: Unknown
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: Use your secret API key as the bearer token

````