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

# Get

> Retrieve the device.



## OpenAPI

````yaml /references/device-api/v0.1.0.yaml get /device
openapi: 3.0.3
info:
  title: Miru API
  version: 0.1.0
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: http://localhost/v1
    description: localhost
security: []
paths:
  /device:
    get:
      tags:
        - Devices
      summary: Get
      description: Retrieve the device.
      operationId: getDevice
      responses:
        '200':
          description: Successfully retrieved the device.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Device'
      x-codeSamples:
        - lang: curl
          source: |-
            curl --unix-socket /run/miru/miru.sock \
              --request GET \
              --url http://localhost/v1/device
        - lang: Python
          source: |-
            from miru_device_sdk import Miru

            client = Miru()
            device = client.device.retrieve()
            print(device.id)
components:
  schemas:
    Device:
      title: Device
      type: object
      required:
        - object
        - id
        - name
        - status
        - last_synced_at
        - last_connected_at
        - last_disconnected_at
      properties:
        object:
          type: string
          enum:
            - device
          example: device
        id:
          type: string
          example: dvc_123
          description: ID of the device.
        name:
          type: string
          example: My Device
          description: Name of the device.
        status:
          $ref: '#/components/schemas/DeviceStatus'
        last_synced_at:
          type: string
          format: date-time
          example: '2021-01-01T00:00:00Z'
          description: Timestamp of when the device was last synced.
        last_connected_at:
          type: string
          format: date-time
          example: '2021-01-01T00:00:00Z'
          description: Timestamp of the last successful connection event with the backend.
        last_disconnected_at:
          type: string
          format: date-time
          example: '2021-01-01T00:00:00Z'
          description: >-
            Timestamp of the last successful disconnection event with the
            backend.
    DeviceStatus:
      type: string
      description: >
        The status of the device.

        - Online: The miru agent is connected

        - Offline: The miru agent is disconnected (e.g. network issues, device
        is powered off, etc.)
      enum:
        - online
        - offline
      x-enum-varnames:
        - DEVICE_STATUS_ONLINE
        - DEVICE_STATUS_OFFLINE

````