Skip to main content
GET
/
core
/
devices
/
{device_id}
Get device details
curl --request GET \
  --url https://acusight.io/api/core/devices/{device_id} \
  --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.

Path Parameters

device_id
string
required

Device ID (numeric or device identifier)

Response

Device details

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)