Skip to main content
GET
/
device
cURL
curl --unix-socket /run/miru/miru.sock \
  --request GET \
  --url http://localhost/v0.2/device
{
  "object": "device",
  "id": "dvc_123",
  "name": "My Device",
  "status": "online",
  "last_synced_at": "2021-01-01T00:00:00Z",
  "last_connected_at": "2021-01-01T00:00:00Z",
  "last_disconnected_at": "2021-01-01T00:00:00Z"
}

Response

200 - application/json

Successfully retrieved the device.

​
object
enum<string>
required

The object type, which is always device.

Available options:
device
Example:

"device"

​
id
string
required

ID of the device.

Example:

"dvc_123"

​
name
string
required

Name of the device.

Example:

"My Device"

​
status
enum<string>
required

The status of the device.

  • Online: The miru agent is connected
  • Offline: The miru agent is disconnected (e.g. network issues, device is powered off, etc.)
Available options:
online,
offline
​
last_synced_at
string<date-time>
required

Timestamp of when the device was last synced.

Example:

"2021-01-01T00:00:00Z"

​
last_connected_at
string<date-time>
required

Timestamp of the last successful connection event with the backend.

Example:

"2021-01-01T00:00:00Z"

​
last_disconnected_at
string<date-time>
required

Timestamp of the last successful disconnection event with the backend.

Example:

"2021-01-01T00:00:00Z"

Last modified on March 13, 2026