Devices

List devices

GET/v1/sources

Returns all devices the API key has access to, with online status and last-seen timestamp.

Query params

Param	Values	Description
`status`	`online` \| `offline`	Filter by connection status

Example


curl "https://api.plexus.company/v1/sources?status=online" \
  -H "x-api-key: YOUR_API_KEY"

Response


{
  "devices": [
    {
      "source_id": "robot-01",
      "online": true,
      "last_seen_ms": 1746969600000
    },
    {
      "source_id": "robot-02",
      "online": false,
      "last_seen_ms": 1746883200000
    }
  ]
}

last_seen_ms is a Unix timestamp in milliseconds. null if the device has never been seen.

Get device

GET/v1/sources/{source_id}

Returns a single device. Returns 404 if the device has never sent data.

Example


curl https://api.plexus.company/v1/sources/robot-01 \
  -H "x-api-key: YOUR_API_KEY"

Response


{
  "source_id": "robot-01",
  "online": true,
  "last_seen_ms": 1746969600000
}