---
title: "Get Device Details"
url: "https://public-api-docs.cipherscale.com/apis/cipherscale-api-1/versions/fef69080-6094-4620-8bf0-16fd2de7b598/operations/DevicesController_findById"
---

> Full API specification: https://public-api-docs.cipherscale.com/apis/cipherscale-api-1/versions/fef69080-6094-4620-8bf0-16fd2de7b598.md

# Get Device Details

`GET` `/tenants/devices/{id}`

Operation ID: `DevicesController_findById`

Retrieves comprehensive information about a specific device including its configuration, connection status, associated user, hardware details, and security posture information.

## Path parameters

- `id` (string, uuid, required) - The unique identifier (UUID) of the device

## Responses

- `200` - Successfully retrieved the device
- `401` - Unauthorized - Invalid or missing authentication token
- `403` - Forbidden - Insufficient permissions. Requires OWNER, ADMIN, or AUDITOR role.
- `404` - Device not found with the provided ID

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Cipherscale API
  version: "1.0"
servers:
  - url: https://public-api.cipherscale.com/qa
    description: Cipherscale Public API Server
paths:
  /tenants/devices/{id}:
    get:
      operationId: DevicesController_findById
      summary: Get Device Details
      description: Retrieves comprehensive information about a specific device
        including its configuration, connection status, associated user,
        hardware details, and security posture information.
      parameters:
        - name: id
          required: true
          in: path
          description: The unique identifier (UUID) of the device
          schema:
            format: uuid
            type: string
          example: 123e4567-e89b-12d3-a456-426614174000
      responses:
        "200":
          description: Successfully retrieved the device
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DeviceDto"
        "401":
          description: Unauthorized - Invalid or missing authentication token
        "403":
          description: Forbidden - Insufficient permissions. Requires OWNER, ADMIN, or
            AUDITOR role.
        "404":
          description: Device not found with the provided ID
      tags:
        - Devices
      security:
        - ApiKeyAuth: []
security:
  - ApiKeyAuth: []
components:
  schemas:
    DeviceDto:
      type: object
      description: Device information including connection status, user association,
        and security posture
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the device
        createdAt:
          format: date-time
          type: string
          description: Timestamp when the device was registered
        updatedAt:
          format: date-time
          type: string
          description: Timestamp when the device information was last updated
        name:
          type: string
          description: Human-readable name for the device
        active:
          type: boolean
          description: Whether the device is currently active and can connect
        lastConnection:
          format: date-time
          type: string
          description: Timestamp of the device's last network connection
        status:
          enum:
            - Online
            - Offline
            - Deactivated
          type: string
          description: Current connection status of the device
        user:
          $ref: "#/components/schemas/DeviceUserDto"
          description: Information about the user who owns this device
        hardwareId:
          type: string
          description: Unique hardware identifier for the device
        posture:
          type: object
          description: Security posture information and compliance status
        appVersion:
          type: string
          description: Version of the Cipherscale client application installed on the device
      required:
        - id
        - createdAt
        - updatedAt
        - name
        - active
        - status
        - hardwareId
    DeviceUserDto:
      type: object
      properties:
        id:
          type: string
          format: uuid
        lastConnection:
          format: date-time
          type: string
        email:
          type: string
        firstName:
          type: string
        lastName:
          type: string
      required:
        - id
        - lastConnection
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
```