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

# Get Session



## OpenAPI

````yaml ../session-openapi.json GET /session/{session_id}
openapi: 3.0.1
info:
  title: Verisoul API
  description: The Verisoul API is used to integrate Verisoul into your application.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.sandbox.verisoul.ai
security:
  - apiKeyAuth: []
paths:
  /session/{session_id}:
    get:
      description: Returns detailed information about a specific session
      parameters:
        - name: session_id
          in: path
          description: ID of the session to retrieve
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Session information response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionResponse'
              example:
                account_ids:
                  - john-doe
                request_id: 7c1fb7c5-8e5f-43f0-b35e-56b9698dac0f
                project_id: 00000000-0000-0000-0000-000000000001
                session_id: 56f9a065-1583-48af-a5c4-cd5921b21a12
                start_time: '2025-06-10T16:45:21.822Z'
                true_country_code: US
                device_id: 6yONB4zT6k2i7SXvWkwC9s
                network:
                  ip_address: 2600:1700:261:b810:8828:f0b6:3b95:667c
                  service_provider: AT&T Enterprises, LLC
                  connection_type: isp
                location:
                  continent: NA
                  country_code: US
                  state: Texas
                  city: Austin
                  zip_code: '78729'
                  timezone: America/Chicago
                  latitude: 30.4521
                  longitude: -97.7688
                browser:
                  type: Chrome
                  version: 137.0.0.0
                  language: en-US
                  user_agent: >-
                    Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)
                    AppleWebKit/537.36 (KHTML, like Gecko) Chrome/137.0.0.0
                    Safari/537.36
                  timezone: America/Chicago
                device:
                  category: desktop
                  type: Mac
                  os: macOS 10.15.7
                  cpu_cores: 16
                  memory: 8
                  gpu: >-
                    ANGLE (Apple, ANGLE Metal Renderer: Apple M4 Max,
                    Unspecified Version)
                  screen_height: 1329
                  screen_width: 2056
                bot:
                  mouse_num_events: 84
                  click_num_events: 2
                  keyboard_num_events: 0
                  touch_num_events: 0
                  clipboard_num_events: 1
                risk_signals:
                  device_risk: false
                  proxy: false
                  vpn: false
                  tor: false
                  spoofed_ip: false
                  datacenter: false
                  recent_fraud_ip: false
                  impossible_travel: false
                  device_network_mismatch: false
                  location_spoofing: false
                risk_signal_scores:
                  device_risk: 0.3971
                  proxy: 0
                  vpn: 0
                  tor: 0
                  datacenter: 0
                  recent_fraud_ip: 0
                  impossible_travel: 0
                  device_network_mismatch: 0.0001
                  location_spoofing: 0
        '400':
          description: Session not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SessionError'
              example:
                statusCode: 400
                message: Session ID not found
components:
  schemas:
    SessionResponse:
      type: object
      properties:
        account_ids:
          type: array
          items:
            type: string
          description: List of account IDs associated with this session
        request_id:
          type: string
          description: The ID of the request
        project_id:
          type: string
          description: The ID of the project
        session_id:
          type: string
          description: The ID of the session
        start_time:
          type: string
          format: date-time
          description: Timestamp when the session started
        true_country_code:
          type: string
          description: The true country code of the session
        device_id:
          type: string
          description: Device identifier from the session
        network:
          type: object
          properties:
            ip_address:
              type: string
              description: IP address of the session
            service_provider:
              type: string
              description: Internet service provider
            connection_type:
              type: string
              description: Type of network connection
        location:
          type: object
          properties:
            continent:
              type: string
              description: Continent code
            country_code:
              type: string
              description: Country code
            state:
              type: string
              description: State or region
            city:
              type: string
              description: City name
            zip_code:
              type: string
              description: Postal/ZIP code
            timezone:
              type: string
              description: Timezone of the location
            latitude:
              type: number
              format: float
              description: Latitude coordinate
            longitude:
              type: number
              format: float
              description: Longitude coordinate
        browser:
          type: object
          properties:
            type:
              type: string
              description: Browser type
            version:
              type: string
              description: Browser version
            language:
              type: string
              description: Browser language setting
            user_agent:
              type: string
              description: User agent string
            timezone:
              type: string
              description: Browser timezone setting
        device:
          type: object
          properties:
            category:
              type: string
              enum:
                - desktop
                - mobile
                - tablet
                - console
                - smarttv
                - wearable
                - embedded
                - other
              description: >-
                Device category. See [Device
                Categories](/signals-scores/device#device-categories) for
                details.
            type:
              type: string
              description: Device type
            os:
              type: string
              description: Operating system
            cpu_cores:
              type: integer
              description: Number of CPU cores
            memory:
              type: integer
              description: Amount of memory in GB
            gpu:
              type: string
              description: GPU information
            screen_height:
              type: number
              description: Screen height in pixels
            screen_width:
              type: number
              description: Screen width in pixels
        bot:
          type: object
          properties:
            mouse_num_events:
              type: integer
              description: Number of mouse events
            click_num_events:
              type: integer
              description: Number of click events
            keyboard_num_events:
              type: integer
              description: Number of keyboard events
            touch_num_events:
              type: integer
              description: Number of touch events
            clipboard_num_events:
              type: integer
              description: Number of clipboard events
        risk_signals:
          type: object
          properties:
            device_risk:
              type: boolean
              description: Device risk flag
            proxy:
              type: boolean
              description: Proxy usage flag
            vpn:
              type: boolean
              description: VPN usage flag
            tor:
              type: boolean
              description: Tor usage flag
            spoofed_ip:
              type: boolean
              description: Spoofed IP flag
            datacenter:
              type: boolean
              description: Datacenter IP flag
            recent_fraud_ip:
              type: boolean
              description: Recent fraud IP flag
            impossible_travel:
              type: boolean
              description: Impossible travel flag
            device_network_mismatch:
              type: boolean
              description: Device network mismatch flag
            location_spoofing:
              type: boolean
              description: Location spoofing flag
        risk_signal_scores:
          type: object
          properties:
            device_risk:
              type: number
              format: float
              description: Device risk score
            proxy:
              type: number
              format: float
              description: Proxy detection score
            vpn:
              type: number
              format: float
              description: VPN detection score
            tor:
              type: number
              format: float
              description: Tor detection score
            datacenter:
              type: number
              format: float
              description: Datacenter detection score
            recent_fraud_ip:
              type: number
              format: float
              description: Recent fraud IP detection score
            impossible_travel:
              type: number
              format: float
              description: Impossible travel detection score
            device_network_mismatch:
              type: number
              format: float
              description: Device network mismatch score
            location_spoofing:
              type: number
              format: float
              description: Location spoofing detection score
    SessionError:
      type: object
      properties:
        message:
          type: string
          description: Error message
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````