> ## 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 Session Data

> 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`](/api-reference/events-data) endpoint to retrieve a session's event log.



## OpenAPI

````yaml GET /v1/sessions/{sessionId}/report
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/sessions/{sessionId}/report:
    get:
      summary: Retrieve data for a specific session
      description: >-
        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`](/api-reference/events-data) endpoint
        to retrieve a session's event log.
      parameters:
        - name: sessionId
          in: path
          required: true
          schema:
            type: string
          description: >-
            The unique session identifier (from
            `window.getRoundtableSessionId()`)
      responses:
        '200':
          description: Session data retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  session_id:
                    type: string
                    description: Unique identifier for the session
                    example: abc123def456
                  user_id:
                    type: string
                    description: >-
                      User identifier provided during script initialization (if
                      any)
                    example: user-456
                  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 score for the session (0-100). Higher scores
                      indicate higher risk.
                    example: 75
                  risk_explanation:
                    type: string
                    description: >-
                      Short explanation of the factors contributing to the risk
                      score
                    example: >-
                      User was flagged for multiple likely bot behavior,
                      indicating a medium to high risk of fraud.
                  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
                    example:
                      - 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:
                    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 may not be running on a
                          standard local device
                        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

````