Skip to main content
GET
/
devices
/
{id}
{
  "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"
}
Returns a single device. The id path parameter accepts either short_id or hardware_id.

​
Path parameters

​
id
string
required
Device identifier — either short_id or hardware_id.

​
Response

Returns a device object with the same shape as items in the List Devices response.
​
short_id
string
required
Short, human-friendly device identifier.
​
hardware_id
string
required
Hardware identifier.
​
device_type
string
required
Device type.
​
name
string
Display name.
​
attributes
object
required
Latest telemetry attributes.
​
is_online
boolean
Whether the device is currently connected.
​
created_at
string
required
ISO 8601 creation timestamp.
​
updated_at
string
required
ISO 8601 last update timestamp.

​
Errors

StatusDescription
403Device not within your access scope
404Device not found
bash curl -H "X-API-Key: YOUR_API_KEY" \ https://your-api-host/devices/ABC123
{
  "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"
}