---
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

## Changes

- **2026-03-09** `d3b8f05f7a0f` — 1 warning, 1 info
  - removed the optional property `metadata` from the response with the `200` status
  - added the optional property `tags` to the response with the `200` status
- **2026-03-07** `48572ed07140` — 1 info
  - added the optional property `metadata` to the response with the `200` status

[Change history](https://skmtc.dev/kernel/apis/hypeman-api/changes/devices/:id/get.md)

---

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