Skip to main content
GET
/
core
/
devices
List devices
curl --request GET \
  --url https://acusight.io/api/core/devices \
  --header 'Authorization: Bearer <token>'
[
  {
    "auto_assign_project": {
      "batches": [
        {
          "created_at": "<string>",
          "device_id": "<string>",
          "id": 123,
          "images": [
            {
              "annotation_status": "<string>",
              "annotations": [
                {
                  "class_value": "<string>",
                  "confidence": 123,
                  "created_at": "<string>",
                  "geometry": [
                    123
                  ],
                  "height": 123,
                  "id": 123,
                  "image_id": 123,
                  "model_id": "<string>",
                  "model_name": "<string>",
                  "model_version": "<string>",
                  "source": "<string>",
                  "type": "<string>",
                  "updated_at": "<string>",
                  "width": 123,
                  "x_center": 123,
                  "y_center": 123,
                  "z_order": 123
                }
              ],
              "batch": "<unknown>",
              "batch_id": 123,
              "created_at": "<string>",
              "device_id": "<string>",
              "filename": "<string>",
              "height": 123,
              "id": 123,
              "split": "<string>",
              "split_locked": true,
              "storage_key": "<string>",
              "updated_at": "<string>",
              "width": 123
            }
          ],
          "last_image_received_at": "<string>",
          "name": "<string>",
          "organization_id": "<string>",
          "project": "<unknown>",
          "project_id": 123,
          "source": "<string>",
          "stage": "<string>",
          "status": "<string>",
          "tags": [
            "<string>"
          ],
          "updated_at": "<string>"
        }
      ],
      "classes": [
        {
          "color": "<string>",
          "created_at": "<string>",
          "id": 123,
          "name": "<string>",
          "project": "<unknown>",
          "project_id": 123,
          "raw_value": "<string>",
          "updated_at": "<string>"
        }
      ],
      "created_at": "<string>",
      "description": "<string>",
      "id": 123,
      "name": "<string>",
      "organization_id": "<string>",
      "project_type": "<string>",
      "updated_at": "<string>",
      "versions": [
        {
          "created_at": "<string>",
          "id": 123,
          "name": "<string>",
          "pipeline_config": [
            123
          ],
          "project": "<unknown>",
          "project_id": 123,
          "updated_at": "<string>",
          "version": 123,
          "version_annotations": [
            {
              "geometry": [
                123
              ],
              "height": 123,
              "id": 123,
              "original_annotation": {
                "class_value": "<string>",
                "confidence": 123,
                "created_at": "<string>",
                "geometry": [
                  123
                ],
                "height": 123,
                "id": 123,
                "image_id": 123,
                "model_id": "<string>",
                "model_name": "<string>",
                "model_version": "<string>",
                "source": "<string>",
                "type": "<string>",
                "updated_at": "<string>",
                "width": 123,
                "x_center": 123,
                "y_center": 123,
                "z_order": 123
              },
              "original_annotation_id": 123,
              "type": "<string>",
              "version": "<unknown>",
              "version_class_value": "<string>",
              "version_id": 123,
              "version_image": {
                "annotations": "<array>",
                "filename": "<string>",
                "height": 123,
                "id": 123,
                "original_image": {
                  "annotation_status": "<string>",
                  "annotations": [
                    {
                      "class_value": "<string>",
                      "confidence": 123,
                      "created_at": "<string>",
                      "geometry": [
                        123
                      ],
                      "height": 123,
                      "id": 123,
                      "image_id": 123,
                      "model_id": "<string>",
                      "model_name": "<string>",
                      "model_version": "<string>",
                      "source": "<string>",
                      "type": "<string>",
                      "updated_at": "<string>",
                      "width": 123,
                      "x_center": 123,
                      "y_center": 123,
                      "z_order": 123
                    }
                  ],
                  "batch": "<unknown>",
                  "batch_id": 123,
                  "created_at": "<string>",
                  "device_id": "<string>",
                  "filename": "<string>",
                  "height": 123,
                  "id": 123,
                  "split": "<string>",
                  "split_locked": true,
                  "storage_key": "<string>",
                  "updated_at": "<string>",
                  "width": 123
                },
                "original_image_id": 123,
                "split": "<string>",
                "storage_key": "<string>",
                "version": "<unknown>",
                "version_batch": {
                  "id": 123,
                  "images": "<array>",
                  "name": "<string>",
                  "original_batch": {
                    "created_at": "<string>",
                    "device_id": "<string>",
                    "id": 123,
                    "images": [
                      {
                        "annotation_status": "<string>",
                        "annotations": [
                          {
                            "class_value": "<string>",
                            "confidence": 123,
                            "created_at": "<string>",
                            "geometry": [
                              123
                            ],
                            "height": 123,
                            "id": 123,
                            "image_id": 123,
                            "model_id": "<string>",
                            "model_name": "<string>",
                            "model_version": "<string>",
                            "source": "<string>",
                            "type": "<string>",
                            "updated_at": "<string>",
                            "width": 123,
                            "x_center": 123,
                            "y_center": 123,
                            "z_order": 123
                          }
                        ],
                        "batch": "<unknown>",
                        "batch_id": 123,
                        "created_at": "<string>",
                        "device_id": "<string>",
                        "filename": "<string>",
                        "height": 123,
                        "id": 123,
                        "split": "<string>",
                        "split_locked": true,
                        "storage_key": "<string>",
                        "updated_at": "<string>",
                        "width": 123
                      }
                    ],
                    "last_image_received_at": "<string>",
                    "name": "<string>",
                    "organization_id": "<string>",
                    "project": "<unknown>",
                    "project_id": 123,
                    "source": "<string>",
                    "stage": "<string>",
                    "status": "<string>",
                    "tags": [
                      "<string>"
                    ],
                    "updated_at": "<string>"
                  },
                  "original_batch_id": 123,
                  "project_id": 123,
                  "version": "<unknown>",
                  "version_id": 123
                },
                "version_batch_id": 123,
                "version_id": 123,
                "width": 123
              },
              "version_image_id": 123,
              "width": 123,
              "x_center": 123,
              "y_center": 123
            }
          ],
          "version_batches": [
            {
              "id": 123,
              "images": "<array>",
              "name": "<string>",
              "original_batch": {
                "created_at": "<string>",
                "device_id": "<string>",
                "id": 123,
                "images": [
                  {
                    "annotation_status": "<string>",
                    "annotations": [
                      {
                        "class_value": "<string>",
                        "confidence": 123,
                        "created_at": "<string>",
                        "geometry": [
                          123
                        ],
                        "height": 123,
                        "id": 123,
                        "image_id": 123,
                        "model_id": "<string>",
                        "model_name": "<string>",
                        "model_version": "<string>",
                        "source": "<string>",
                        "type": "<string>",
                        "updated_at": "<string>",
                        "width": 123,
                        "x_center": 123,
                        "y_center": 123,
                        "z_order": 123
                      }
                    ],
                    "batch": "<unknown>",
                    "batch_id": 123,
                    "created_at": "<string>",
                    "device_id": "<string>",
                    "filename": "<string>",
                    "height": 123,
                    "id": 123,
                    "split": "<string>",
                    "split_locked": true,
                    "storage_key": "<string>",
                    "updated_at": "<string>",
                    "width": 123
                  }
                ],
                "last_image_received_at": "<string>",
                "name": "<string>",
                "organization_id": "<string>",
                "project": "<unknown>",
                "project_id": 123,
                "source": "<string>",
                "stage": "<string>",
                "status": "<string>",
                "tags": [
                  "<string>"
                ],
                "updated_at": "<string>"
              },
              "original_batch_id": 123,
              "project_id": 123,
              "version": "<unknown>",
              "version_id": 123
            }
          ],
          "version_classes": [
            {
              "color": "<string>",
              "id": 123,
              "name": "<string>",
              "original_class": {
                "color": "<string>",
                "created_at": "<string>",
                "id": 123,
                "name": "<string>",
                "project": "<unknown>",
                "project_id": 123,
                "raw_value": "<string>",
                "updated_at": "<string>"
              },
              "original_class_id": 123,
              "raw_value": "<string>",
              "version": "<unknown>",
              "version_id": 123
            }
          ],
          "version_images": [
            {
              "annotations": "<array>",
              "filename": "<string>",
              "height": 123,
              "id": 123,
              "original_image": {
                "annotation_status": "<string>",
                "annotations": [
                  {
                    "class_value": "<string>",
                    "confidence": 123,
                    "created_at": "<string>",
                    "geometry": [
                      123
                    ],
                    "height": 123,
                    "id": 123,
                    "image_id": 123,
                    "model_id": "<string>",
                    "model_name": "<string>",
                    "model_version": "<string>",
                    "source": "<string>",
                    "type": "<string>",
                    "updated_at": "<string>",
                    "width": 123,
                    "x_center": 123,
                    "y_center": 123,
                    "z_order": 123
                  }
                ],
                "batch": "<unknown>",
                "batch_id": 123,
                "created_at": "<string>",
                "device_id": "<string>",
                "filename": "<string>",
                "height": 123,
                "id": 123,
                "split": "<string>",
                "split_locked": true,
                "storage_key": "<string>",
                "updated_at": "<string>",
                "width": 123
              },
              "original_image_id": 123,
              "split": "<string>",
              "storage_key": "<string>",
              "version": "<unknown>",
              "version_batch": {
                "id": 123,
                "images": "<array>",
                "name": "<string>",
                "original_batch": {
                  "created_at": "<string>",
                  "device_id": "<string>",
                  "id": 123,
                  "images": [
                    {
                      "annotation_status": "<string>",
                      "annotations": [
                        {
                          "class_value": "<string>",
                          "confidence": 123,
                          "created_at": "<string>",
                          "geometry": [
                            123
                          ],
                          "height": 123,
                          "id": 123,
                          "image_id": 123,
                          "model_id": "<string>",
                          "model_name": "<string>",
                          "model_version": "<string>",
                          "source": "<string>",
                          "type": "<string>",
                          "updated_at": "<string>",
                          "width": 123,
                          "x_center": 123,
                          "y_center": 123,
                          "z_order": 123
                        }
                      ],
                      "batch": "<unknown>",
                      "batch_id": 123,
                      "created_at": "<string>",
                      "device_id": "<string>",
                      "filename": "<string>",
                      "height": 123,
                      "id": 123,
                      "split": "<string>",
                      "split_locked": true,
                      "storage_key": "<string>",
                      "updated_at": "<string>",
                      "width": 123
                    }
                  ],
                  "last_image_received_at": "<string>",
                  "name": "<string>",
                  "organization_id": "<string>",
                  "project": "<unknown>",
                  "project_id": 123,
                  "source": "<string>",
                  "stage": "<string>",
                  "status": "<string>",
                  "tags": [
                    "<string>"
                  ],
                  "updated_at": "<string>"
                },
                "original_batch_id": 123,
                "project_id": 123,
                "version": "<unknown>",
                "version_id": 123
              },
              "version_batch_id": 123,
              "version_id": 123,
              "width": 123
            }
          ]
        }
      ]
    },
    "auto_assign_to": 123,
    "compose_file_path": "<string>",
    "config_last_sync": "<string>",
    "created_at": "<string>",
    "deployed_model_version_id": 123,
    "deployed_via_alias": "<string>",
    "device_id": "<string>",
    "device_type": "<string>",
    "edge_key": "<string>",
    "hls_port": 123,
    "id": 123,
    "ip_address": "<string>",
    "last_seen": "<string>",
    "last_snapshot_at": "<string>",
    "name": "<string>",
    "next_batch_number": 123,
    "organization": {
      "created_at": "<string>",
      "external_id": "<string>",
      "id": "<string>",
      "name": "<string>",
      "settings": "<string>",
      "slug": "<string>",
      "updated_at": "<string>"
    },
    "organization_id": "<string>",
    "portainer_endpoint_id": 123,
    "provisioned_at": "<string>",
    "provisioned_by": "<string>",
    "status": "<string>",
    "stream_path": "<string>",
    "updated_at": "<string>",
    "virtual_device_config": {
      "active_track_count": 123,
      "batch_size": 123,
      "created_at": "<string>",
      "current_image_index": 123,
      "dataset_format": "<string>",
      "dataset_path": "<string>",
      "dataset_version_id": 123,
      "device_id": "<string>",
      "event_frequency": 123,
      "event_types": "<string>",
      "id": 123,
      "loop": true,
      "max_concurrent_tracks": 123,
      "random_order": true,
      "simulation_mode": "<string>",
      "simulation_status": "<string>",
      "total_events_sent": 123,
      "total_images": 123,
      "total_images_uploaded": 123,
      "track_max_duration": 123,
      "track_min_duration": 123,
      "updated_at": "<string>",
      "upload_frequency": 123
    },
    "watchman_port": 123,
    "webrtc_port": 123
  }
]

Authorizations

Authorization
string
header
required

JWT access token. Paste the token only; the Bearer prefix is added automatically.

Query Parameters

status
string

Filter by device status

device_type
string

Filter by device type ('physical' or 'virtual')

deployed_model_version_id
string

Filter by deployed model version ID (use 'null' for devices without models)

limit
integer

Number of results to return (default 50, max 500)

offset
integer

Number of results to skip (default 0)

order
string

Sort order: 'asc' or 'desc' (default 'desc')

Response

List of devices with metadata

auto_assign_project
object
auto_assign_to
integer

Auto-assign to ProjectID

compose_file_path
string

Path to docker-compose.yml on device

config_last_sync
string

When config was last extracted

created_at
string
deployed_model_version_id
integer

Currently deployed model (FK to ml_model_versions)

deployed_via_alias
string

How this device was deployed: "champion", "canary", "challenger", or NULL

device_id
string

Docker daemon ID from 'docker system info'

device_type
string

"physical" | "virtual"

edge_key
string

Temporary storage for Portainer edge key (cleared after deployment)

hls_port
integer

MediaMTX HLS port (default: 8888)

id
integer
ip_address
string

Network configuration for live streaming (WebRTC)

last_seen
string

Heartbeat and model tracking

last_snapshot_at
string

Timestamp of most recent snapshot upload

name
string
next_batch_number
integer

Sequential numbering

organization
object

Relationships

organization_id
string

Multi-tenant fields

portainer_endpoint_id
integer

Links to Portainer endpoint

provisioned_at
string

When device was provisioned via token

provisioned_by
string

Token ID that provisioned this device

status
string

pending, approved, deployed, rejected

stream_path
string

Stream path on MediaMTX (default: "sp")

updated_at
string
virtual_device_config
object
watchman_port
integer

Edge service configuration (auto-discovered or manual override)

webrtc_port
integer

MediaMTX WebRTC port (default: 8889)