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

# Get Device

> Retrieve a single device by short_id or hardware_id.

Returns a single device. The `id` path parameter accepts either `short_id` or `hardware_id`.

## Path parameters

<ParamField path="id" type="string" required>
  Device identifier — either `short_id` or `hardware_id`.
</ParamField>

## Response

Returns a device object with the same shape as items in the [List Devices](/api-reference/user/list-devices) response.

<ResponseField name="short_id" type="string" required>
  Short, human-friendly device identifier.
</ResponseField>

<ResponseField name="hardware_id" type="string" required>
  Hardware identifier.
</ResponseField>

<ResponseField name="device_type" type="string" required>
  Device type.
</ResponseField>

<ResponseField name="name" type="string">
  Display name.
</ResponseField>

<ResponseField name="attributes" type="object" required>
  Latest telemetry attributes.
</ResponseField>

<ResponseField name="is_online" type="boolean">
  Whether the device is currently connected.
</ResponseField>

<ResponseField name="created_at" type="string" required>
  ISO 8601 creation timestamp.
</ResponseField>

<ResponseField name="updated_at" type="string" required>
  ISO 8601 last update timestamp.
</ResponseField>

## Errors

| Status | Description                         |
| ------ | ----------------------------------- |
| `403`  | Device not within your access scope |
| `404`  | Device not found                    |

<RequestExample>`bash curl -H "X-API-Key: YOUR_API_KEY" \ https://your-api-host/devices/ABC123 `</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "short_id": "a1b2c3d4",
    "hardware_id": "ABC123",
    "device_type": "teebox",
    "name": " ",
    "attributes": {
      "lat": 37.7749,
      "long": -122.4194,
      "battery_voltage": 12.4,
      "lock_status": 0
    },
    "is_online": true,
    "created_at": "2025-12-01T00:00:00.000Z",
    "updated_at": "2025-12-17T10:30:00.000Z"
  }
  ```
</ResponseExample>