Skip to main content
GET
/
data
/
images
List images
curl --request GET \
  --url https://acusight.io/api/data/images \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "annotation_status": "<string>",
      "annotations": [
        {
          "class_value": "<string>",
          "confidence": 123,
          "created_at": "<string>",
          "geometry": [
            123
          ],
          "height": 123,
          "id": 123,
          "image_id": 123,
          "source": "<string>",
          "type": "<string>",
          "updated_at": "<string>",
          "width": 123,
          "x_center": 123,
          "y_center": 123,
          "z_order": 123
        }
      ],
      "batch_id": 123,
      "batch_name": "<string>",
      "created_at": "<string>",
      "device_id": "<string>",
      "filename": "<string>",
      "height": 123,
      "id": 123,
      "image_url": "<string>",
      "project_name": "<string>",
      "split": "<string>",
      "split_locked": true,
      "storage_key": "<string>",
      "updated_at": "<string>",
      "version_name": "<string>",
      "width": 123
    }
  ],
  "error": {
    "code": "<string>",
    "details": "<string>",
    "message": "<string>"
  },
  "meta": {
    "count": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "success": true
}

Authorizations

Authorization
string
header
required

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

Query Parameters

project_id
string

Filter by project ID (use 'null' for unassigned)

batch_id
string

Filter by batch ID

device_id
string

Filter by device identifier

stage
string

Filter by batch stage when project_id provided

annotation_status
string

Filter by annotation status

split
string

Filter by dataset split (train, val, test, none, all)

class_values
string

Comma-separated class values to filter

Search by filename substring

filename
string

Exact filename filter

include_image_url
boolean

Include signed image URL in results

include_annotations
boolean

Include annotation payloads

limit
integer

Page size (default 50, max 100)

offset
integer

Result offset

sort
string

Sort field (created_at, updated_at, filename)

order
string

Sort direction (asc or desc)

Response

Paginated image list

data
object[]
error
object
meta
object
success
boolean