API Reference
WS detail/list (thumbnail)

Thumbnails

Camera thumbnails associated with a location, recording, line, or area.

Returns camera thumbnails for the requested entity. Use them to visually anchor an analytics view to the camera frame the data came from. Returned via detail/list with returnEntityType: "thumbnail".

For thumbnails with stat-element coordinates overlaid (lines, areas), use Thumbnails with overlays.

Body parameters

Standard detail request envelope. Set returnEntityType: "thumbnail". Filter fields are optional.

Optional filter fields

FieldTypeDescription
startstring (ISO 8601)Restrict to a time range
endstring (ISO 8601)Restrict to a time range
lineTypestringRestrict to a line type
areaTypestringRestrict to an area type
taxonomystringRestrict to a zone path

Example request

{
  "action": "detail",
  "data": {
    "id": "req-th-001",
    "route": "detail/list",
    "body": {
      "returnEntityType": "thumbnail",
      "entities": ["64a1b2c3d4e5f6a7b8c9d0e3"],
      "entityType": "location"
    }
  }
}

Example response

req-th-001|0|0|[
  {
    "organisation_id": "64a1b2c3d4e5f6a7b8c9d0e2",
    "location_id": "64a1b2c3d4e5f6a7b8c9d0e3",
    "recording_id": "64a1b2c3d4e5f6a7b8c9d0e4",
    "url": "https://thumbnailer.auravisionlabs.com/<signed-key>",
    "local_time": "2024-04-01T10:30:00.000"
  },
  {
    "organisation_id": "64a1b2c3d4e5f6a7b8c9d0e2",
    "location_id": "64a1b2c3d4e5f6a7b8c9d0e3",
    "recording_id": "64a1b2c3d4e5f6a7b8c9d0e5",
    "url": "https://thumbnailer.auravisionlabs.com/<signed-key>",
    "local_time": "2024-04-01T10:30:00.000"
  }
]

Thumbnail URLs are signed with a short expiry — fetch them with GET, don’t persist the URL.