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

# List Devices



## OpenAPI

````yaml /api-reference/openapi.json get /api/runtime-security/agent/devices
openapi: 3.1.0
info:
  title: Blindsight API
  version: 0.1.0
  description: >-
    The full Blindsight REST surface, generated from the running application.
    Replace the server host with your own deployment.


    For the Runtime Security integration surface (scan, proxy, tool calls) see
    the Runtime Security spec, which is hand written and carries worked
    examples.
servers:
  - url: https://api.your-blindsight.com
    description: Your Blindsight deployment
security: []
paths:
  /api/runtime-security/agent/devices:
    get:
      tags:
        - runtime-security-agent
      summary: List Devices
      operationId: list_devices_api_runtime_security_agent_devices_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/DeviceRead'
                type: array
                title: Response List Devices Api Runtime Security Agent Devices Get
components:
  schemas:
    DeviceRead:
      properties:
        uuid:
          type: string
          title: Uuid
        hostname:
          anyOf:
            - type: string
            - type: 'null'
          title: Hostname
        platform:
          anyOf:
            - type: string
            - type: 'null'
          title: Platform
        os_user:
          anyOf:
            - type: string
            - type: 'null'
          title: Os User
        os_version:
          anyOf:
            - type: string
            - type: 'null'
          title: Os Version
        agent_version:
          anyOf:
            - type: string
            - type: 'null'
          title: Agent Version
        status:
          type: string
          title: Status
        user_id:
          anyOf:
            - type: integer
            - type: 'null'
          title: User Id
        user_email:
          anyOf:
            - type: string
            - type: 'null'
          title: User Email
        identity_status:
          type: string
          title: Identity Status
          default: pending
        protection_state:
          anyOf:
            - type: string
            - type: 'null'
          title: Protection State
        protection_state_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Protection State At
        tamper_count:
          type: integer
          title: Tamper Count
          default: 0
        last_tamper_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Tamper At
        last_tamper_kind:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Tamper Kind
        agent_started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Agent Started At
        last_exit_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Exit At
        last_exit_reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Exit Reason
        policy_revision:
          anyOf:
            - type: integer
            - type: 'null'
          title: Policy Revision
        effective_settings:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Effective Settings
        effective_settings_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Effective Settings At
        install_kind:
          anyOf:
            - type: string
            - type: 'null'
          title: Install Kind
        enrolled_at:
          type: string
          format: date-time
          title: Enrolled At
        last_seen_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Seen At
        last_active_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Last Active At
        revoked_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Revoked At
        reenrollment_allowed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Reenrollment Allowed At
        reenrollment_allowed_by_email:
          anyOf:
            - type: string
            - type: 'null'
          title: Reenrollment Allowed By Email
        blocked_reenroll_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Blocked Reenroll At
        blocked_reenroll_count:
          type: integer
          title: Blocked Reenroll Count
          default: 0
        paused:
          type: boolean
          title: Paused
          default: false
        paused_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Paused At
        paused_by_email:
          anyOf:
            - type: string
            - type: 'null'
          title: Paused By Email
        online:
          type: boolean
          title: Online
          default: false
        protected:
          type: boolean
          title: Protected
          default: false
      type: object
      required:
        - uuid
        - hostname
        - platform
        - os_user
        - os_version
        - agent_version
        - status
        - user_id
        - enrolled_at
        - last_seen_at
        - revoked_at
      title: DeviceRead

````