Devices
Get Device
Retrieve details of a specific device
GET
Retrieve the full details of a specific device, including settings and current health status.Documentation Index
Fetch the complete documentation index at: https://docs.bota.dev/llms.txt
Use this file to discover all available pages before exploring further.
Authentication
Requires an API key withdevices:read scope.
Path Parameters
The device’s unique identifier (e.g.,
dev_abc123).Response
Returns the device object.Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Device identifier (dev_*) |
serial_number | string | Physical serial number |
model | string | Device model (bota_pin or bota_note) |
firmware_version | string | null | Current firmware version |
status | string | unbound or bound |
end_user_id | string | null | Bound end user (eu_*), null if unbound |
battery_percent | integer | null | Battery level (0-100), null if no heartbeat received |
storage_used_mb | integer | null | Storage used in MB |
storage_total_mb | integer | null | Total storage capacity in MB |
signal_strength_dbm | integer | null | Signal strength in dBm |
last_heartbeat_at | string | null | Last heartbeat timestamp (ISO 8601) |
recording_state | object | null | Current recording state (device_state, pending_recordings, flags, connection_type[]) |
metadata | object | Custom key-value metadata |
settings | object | Device settings including connection, upload, audio, and power configuration |
created_at | string | Creation timestamp (ISO 8601) |
updated_at | string | Last update timestamp (ISO 8601) |

