---
title: "Get device details"
method: GET
path: "/devices/{id}"
---

# Get device details

`GET /devices/{id}`

## Path parameters

- `id` string, required

## Response `200`

Device details

- Device
  - `id` string, required — Auto-generated unique identifier (CUID2 format)
  - `name` string — Device name (user-provided or auto-generated from PCI address)
  - `type` 'gpu' | 'pci', required — Type of PCI device
  - `tags` Tags — User-defined key-value tags.
  - `pci_address` string, required — PCI address
  - `vendor_id` string, required — PCI vendor ID (hex)
  - `device_id` string, required — PCI device ID (hex)
  - `iommu_group` integer, required — IOMMU group number
  - `bound_to_vfio` boolean, required — Whether the device is currently bound to the vfio-pci driver, which is required for VM passthrough. - true: Device is bound to vfio-pci and ready for (or currently in use by) a VM. The device's native driver has been unloaded. - false: Device is using its native driver (e.g., nvidia) or no driver. Hypeman will automatically bind to vfio-pci when attaching to an instance.
  - `attached_to` string, nullable — Instance ID if attached
  - `created_at` string, date-time, required — Registration timestamp (RFC3339)

## Other responses

- `404` — Device not found
- `500` — Internal server error

---

[API](https://skmtc.net/kernel/apis/hypeman-api.md) · [All operations](https://skmtc.net/kernel/apis/hypeman-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kernel/hypeman-api/versions/b4642bb950dc/schema)