---
title: "Batch query data annotation result of dataset"
method: GET
path: "/dataset/batchDataAnnotationResult/{datasetId}"
tags: ["Open API/Dataset"]
---

# Batch query data annotation result of dataset

`GET /dataset/batchDataAnnotationResult/{datasetId}`

Batch query the annotation results of data under the dataset. If no source is specified, return all results.

## Path parameters

- `datasetId` integer, required

## Query parameters

- `sourceIds` integer
- `dataIds` integer, required

## Headers

- `Authorization` string

## Response `200`

Success

- object
  - `code` string, required — Error code, OK indicates success, while others indicate failure
  - `message` string, required — Error message
  - `data` DataAnnotationResult[], required — Response data; will be null if it is empty
    - `dataId` integer, required — Data ID, ignored when importing
    - `sourceId` integer, required — Result source ID, ignored when importing
    - `sourceType` 'DATA_FLOW' | 'TASK' | 'MODEL' | 'EXTERNAL_GROUND_TRUTH' | 'EXTERNAL_MODEL', required — Result source Type
    - `sourceName` string, required — Result source Name
    - `validity` 'VALID' | 'INVALID', required — Data validity
    - `classifications` Classification[], required — Classifications
      - `id` string, required — ID
      - `classificationId` string, required — Classification template ID
      - `classificationVersion` integer, required — Classification template version
      - `values` object[], required — Attribute values
        - `id` string, required — Attribute ID
        - `attributeVersion` integer, required — Attribute value version
        - `pid` string, nullable, required — Parent attribute ID
        - `pvalue` string, nullable, required — Parent attribute value, only needed when parent selected multiple values
        - `name` string, required — Attribute name
        - `type` string, required — Attribute type
        - `value` string, required — Attribute value
        - `alias` string, required — Attribute alias
        - `isLeaf` string, required — Is it a leaf node
    - `instances` union[], required — Instance annotation objects
      - union
        - 3DBoxObject
          - `id` string, required — ID
          - `type` '3D_BOX' | '2D_BOX', required — Type, 3D_BOX, 2D_BOX, CHAT_THUMB, CLIP, DIALOG_EVALUATION, DIALOG_RESPONSE etc.
          - `createdBy` integer, required — Creator ID, ignored when importing
          - `createdAt` string, required — Create time, ignored when importing
          - `classId` integer, required — Class template ID, the template must exist in dataset when importing
          - `classVersion` integer, required — Class template version, optional, default to 1
          - `className` string, required — Class name, ignored when importing
          - `classValues` object[], required — Class values, may be nested, flatten into an array
            - `id` string
            - `attributeVersion` integer — 属性版本
            - `pid` integer
            - `pvalue` string
            - `name` string
            - `type` string
            - `value` string[] — Arrange from high to low according to the possibility
            - `alias` string
            - `isLeaf` boolean
          - `deviceName` string, required — Device name, used to distinguish different data files in multimodal data
          - `deviceFrame` integer — Frame of device, only exist when device contains multiple frames, for example, 4D point cloud data contains multiple images for a single camera
          - `groups` string[] — Groups, may be empty or multiple
          - `trackId` string — Tracking object ID
          - `trackName` string — Tracking object name
          - `modelConfidence` number — Model recognition confidence, only when recognized by model
          - `modelClass` string — Model recognition class, only when recognized by model
          - `minDistance` integer — The closest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `maxDistance` integer — The farthest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `minHeight` integer — The maximum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `maxHeight` integer — The minimum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `contour` object, required
        - 2DBoxObject
          - `id` string, required — ID
          - `type` '3D_BOX' | '2D_BOX', required — Type, 3D_BOX, 2D_BOX, CHAT_THUMB, CLIP, DIALOG_EVALUATION, DIALOG_RESPONSE etc.
          - `createdBy` integer, required — Creator ID, ignored when importing
          - `createdAt` string, required — Create time, ignored when importing
          - `classId` integer, required — Class template ID, the template must exist in dataset when importing
          - `classVersion` integer, required — Class template version, optional, default to 1
          - `className` string, required — Class name, ignored when importing
          - `classValues` object[], required — Class values, may be nested, flatten into an array
            - `id` string
            - `attributeVersion` integer — 属性版本
            - `pid` integer
            - `pvalue` string
            - `name` string
            - `type` string
            - `value` string[] — Arrange from high to low according to the possibility
            - `alias` string
            - `isLeaf` boolean
          - `deviceName` string, required — Device name, used to distinguish different data files in multimodal data
          - `deviceFrame` integer — Frame of device, only exist when device contains multiple frames, for example, 4D point cloud data contains multiple images for a single camera
          - `groups` string[] — Groups, may be empty or multiple
          - `trackId` string — Tracking object ID
          - `trackName` string — Tracking object name
          - `modelConfidence` number — Model recognition confidence, only when recognized by model
          - `modelClass` string — Model recognition class, only when recognized by model
          - `minDistance` integer — The closest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `maxDistance` integer — The farthest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `minHeight` integer — The maximum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `maxHeight` integer — The minimum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `contour` object, required
        - GroupObject
          - `id` string, required — ID
          - `type` '3D_BOX' | '2D_BOX', required — Type, 3D_BOX, 2D_BOX, CHAT_THUMB, CLIP, DIALOG_EVALUATION, DIALOG_RESPONSE etc.
          - `createdBy` integer, required — Creator ID, ignored when importing
          - `createdAt` string, required — Create time, ignored when importing
          - `classId` integer, required — Class template ID, the template must exist in dataset when importing
          - `classVersion` integer, required — Class template version, optional, default to 1
          - `className` string, required — Class name, ignored when importing
          - `classValues` object[], required — Class values, may be nested, flatten into an array
            - `id` string
            - `attributeVersion` integer — 属性版本
            - `pid` integer
            - `pvalue` string
            - `name` string
            - `type` string
            - `value` string[] — Arrange from high to low according to the possibility
            - `alias` string
            - `isLeaf` boolean
          - `deviceName` string, required — Device name, used to distinguish different data files in multimodal data
          - `deviceFrame` integer — Frame of device, only exist when device contains multiple frames, for example, 4D point cloud data contains multiple images for a single camera
          - `groups` string[] — Groups, may be empty or multiple
          - `trackId` string — Tracking object ID
          - `trackName` string — Tracking object name
          - `modelConfidence` number — Model recognition confidence, only when recognized by model
          - `modelClass` string — Model recognition class, only when recognized by model
          - `minDistance` integer — The closest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `maxDistance` integer — The farthest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `minHeight` integer — The maximum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `maxHeight` integer — The minimum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
    - `segmentations` union[], required — Segmentation annotation objects
      - union
        - 3DSegmentationObject
          - `id` string, required — ID
          - `type` '3D_BOX' | '2D_BOX', required — Type, 3D_BOX, 2D_BOX, CHAT_THUMB, CLIP, DIALOG_EVALUATION, DIALOG_RESPONSE etc.
          - `createdBy` integer, required — Creator ID, ignored when importing
          - `createdAt` string, required — Create time, ignored when importing
          - `classId` integer, required — Class template ID, the template must exist in dataset when importing
          - `classVersion` integer, required — Class template version, optional, default to 1
          - `className` string, required — Class name, ignored when importing
          - `classValues` object[], required — Class values, may be nested, flatten into an array
            - `id` string
            - `attributeVersion` integer — 属性版本
            - `pid` integer
            - `pvalue` string
            - `name` string
            - `type` string
            - `value` string[] — Arrange from high to low according to the possibility
            - `alias` string
            - `isLeaf` boolean
          - `deviceName` string, required — Device name, used to distinguish different data files in multimodal data
          - `deviceFrame` integer — Frame of device, only exist when device contains multiple frames, for example, 4D point cloud data contains multiple images for a single camera
          - `groups` string[] — Groups, may be empty or multiple
          - `trackId` string — Tracking object ID
          - `trackName` string — Tracking object name
          - `modelConfidence` number — Model recognition confidence, only when recognized by model
          - `modelClass` string — Model recognition class, only when recognized by model
          - `minDistance` integer — The closest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `maxDistance` integer — The farthest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `minHeight` integer — The maximum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `maxHeight` integer — The minimum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `no` integer, required — Number, begin from 1
          - `contour` object, required — Source entity id
            - `pointN` integer, required — Including points
        - 2DSegmentationObject
          - `id` string, required — ID
          - `type` '3D_BOX' | '2D_BOX', required — Type, 3D_BOX, 2D_BOX, CHAT_THUMB, CLIP, DIALOG_EVALUATION, DIALOG_RESPONSE etc.
          - `createdBy` integer, required — Creator ID, ignored when importing
          - `createdAt` string, required — Create time, ignored when importing
          - `classId` integer, required — Class template ID, the template must exist in dataset when importing
          - `classVersion` integer, required — Class template version, optional, default to 1
          - `className` string, required — Class name, ignored when importing
          - `classValues` object[], required — Class values, may be nested, flatten into an array
            - `id` string
            - `attributeVersion` integer — 属性版本
            - `pid` integer
            - `pvalue` string
            - `name` string
            - `type` string
            - `value` string[] — Arrange from high to low according to the possibility
            - `alias` string
            - `isLeaf` boolean
          - `deviceName` string, required — Device name, used to distinguish different data files in multimodal data
          - `deviceFrame` integer — Frame of device, only exist when device contains multiple frames, for example, 4D point cloud data contains multiple images for a single camera
          - `groups` string[] — Groups, may be empty or multiple
          - `trackId` string — Tracking object ID
          - `trackName` string — Tracking object name
          - `modelConfidence` number — Model recognition confidence, only when recognized by model
          - `modelClass` string — Model recognition class, only when recognized by model
          - `minDistance` integer — The closest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `maxDistance` integer — The farthest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `minHeight` integer — The maximum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `maxHeight` integer — The minimum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `no` integer, required — Number, begin from 1
          - `contour` object, required — Source entity id
            - `area` integer, required — Area
    - `labelmaps` Labelmap[], required — Labelmaps
      - `resultFilePath` string, required — Labelmap file path
      - `deviceName` string, required — Device name, used to distinguish different data files in multimodal data
      - `segmentNo` string — Segmentation annotation object number, optional, used for each segmentation annotation object has it's own labelmap file
    - `clips` ClipObject[], required
      - `id` string, required — ID
      - `type` '3D_BOX' | '2D_BOX', required — Type, 3D_BOX, 2D_BOX, CHAT_THUMB, CLIP, DIALOG_EVALUATION, DIALOG_RESPONSE etc.
      - `createdBy` integer, required — Creator ID, ignored when importing
      - `createdAt` string, required — Create time, ignored when importing
      - `classId` integer, required — Class template ID, the template must exist in dataset when importing
      - `classVersion` integer, required — Class template version, optional, default to 1
      - `className` string, required — Class name, ignored when importing
      - `classValues` object[], required — Class values, may be nested, flatten into an array
        - `id` string
        - `attributeVersion` integer — 属性版本
        - `pid` integer
        - `pvalue` string
        - `name` string
        - `type` string
        - `value` string[] — Arrange from high to low according to the possibility
        - `alias` string
        - `isLeaf` boolean
      - `deviceName` string, required — Device name, used to distinguish different data files in multimodal data
      - `deviceFrame` integer — Frame of device, only exist when device contains multiple frames, for example, 4D point cloud data contains multiple images for a single camera
      - `groups` string[] — Groups, may be empty or multiple
      - `trackId` string — Tracking object ID
      - `trackName` string — Tracking object name
      - `modelConfidence` number — Model recognition confidence, only when recognized by model
      - `modelClass` string — Model recognition class, only when recognized by model
      - `minDistance` integer — The closest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
      - `maxDistance` integer — The farthest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
      - `minHeight` integer — The maximum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
      - `maxHeight` integer — The minimum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
      - `note` string, required — Note
      - `start` string, required — Start time, unit milliseconds
      - `end` string, required — End time, unit milliseconds
      - `isValid` string, required — Valid or not
    - `dialogs` union[], required
      - union
        - DialogEvaluationObject
          - `id` string, required — ID
          - `type` '3D_BOX' | '2D_BOX', required — Type, 3D_BOX, 2D_BOX, CHAT_THUMB, CLIP, DIALOG_EVALUATION, DIALOG_RESPONSE etc.
          - `createdBy` integer, required — Creator ID, ignored when importing
          - `createdAt` string, required — Create time, ignored when importing
          - `classId` integer, required — Class template ID, the template must exist in dataset when importing
          - `classVersion` integer, required — Class template version, optional, default to 1
          - `className` string, required — Class name, ignored when importing
          - `classValues` object[], required — Class values, may be nested, flatten into an array
            - `id` string
            - `attributeVersion` integer — 属性版本
            - `pid` integer
            - `pvalue` string
            - `name` string
            - `type` string
            - `value` string[] — Arrange from high to low according to the possibility
            - `alias` string
            - `isLeaf` boolean
          - `deviceName` string, required — Device name, used to distinguish different data files in multimodal data
          - `deviceFrame` integer — Frame of device, only exist when device contains multiple frames, for example, 4D point cloud data contains multiple images for a single camera
          - `groups` string[] — Groups, may be empty or multiple
          - `trackId` string — Tracking object ID
          - `trackName` string — Tracking object name
          - `modelConfidence` number — Model recognition confidence, only when recognized by model
          - `modelClass` string — Model recognition class, only when recognized by model
          - `minDistance` integer — The closest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `maxDistance` integer — The farthest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `minHeight` integer — The maximum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `maxHeight` integer — The minimum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `role` string, required — Role
          - `index` integer, required — Dialog index
        - DialogResponseObject
          - `id` string, required — ID
          - `type` '3D_BOX' | '2D_BOX', required — Type, 3D_BOX, 2D_BOX, CHAT_THUMB, CLIP, DIALOG_EVALUATION, DIALOG_RESPONSE etc.
          - `createdBy` integer, required — Creator ID, ignored when importing
          - `createdAt` string, required — Create time, ignored when importing
          - `classId` integer, required — Class template ID, the template must exist in dataset when importing
          - `classVersion` integer, required — Class template version, optional, default to 1
          - `className` string, required — Class name, ignored when importing
          - `classValues` object[], required — Class values, may be nested, flatten into an array
            - `id` string
            - `attributeVersion` integer — 属性版本
            - `pid` integer
            - `pvalue` string
            - `name` string
            - `type` string
            - `value` string[] — Arrange from high to low according to the possibility
            - `alias` string
            - `isLeaf` boolean
          - `deviceName` string, required — Device name, used to distinguish different data files in multimodal data
          - `deviceFrame` integer — Frame of device, only exist when device contains multiple frames, for example, 4D point cloud data contains multiple images for a single camera
          - `groups` string[] — Groups, may be empty or multiple
          - `trackId` string — Tracking object ID
          - `trackName` string — Tracking object name
          - `modelConfidence` number — Model recognition confidence, only when recognized by model
          - `modelClass` string — Model recognition class, only when recognized by model
          - `minDistance` integer — The closest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `maxDistance` integer — The farthest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `minHeight` integer — The maximum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `maxHeight` integer — The minimum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `role` string, required — Role
          - `content` integer, required — Response content
    - `entities` union[], required — Entity annotation objects
      - union
        - EntityObject
          - `id` string, required — ID
          - `type` '3D_BOX' | '2D_BOX', required — Type, 3D_BOX, 2D_BOX, CHAT_THUMB, CLIP, DIALOG_EVALUATION, DIALOG_RESPONSE etc.
          - `createdBy` integer, required — Creator ID, ignored when importing
          - `createdAt` string, required — Create time, ignored when importing
          - `classId` integer, required — Class template ID, the template must exist in dataset when importing
          - `classVersion` integer, required — Class template version, optional, default to 1
          - `className` string, required — Class name, ignored when importing
          - `classValues` object[], required — Class values, may be nested, flatten into an array
            - `id` string
            - `attributeVersion` integer — 属性版本
            - `pid` integer
            - `pvalue` string
            - `name` string
            - `type` string
            - `value` string[] — Arrange from high to low according to the possibility
            - `alias` string
            - `isLeaf` boolean
          - `deviceName` string, required — Device name, used to distinguish different data files in multimodal data
          - `deviceFrame` integer — Frame of device, only exist when device contains multiple frames, for example, 4D point cloud data contains multiple images for a single camera
          - `groups` string[] — Groups, may be empty or multiple
          - `trackId` string — Tracking object ID
          - `trackName` string — Tracking object name
          - `modelConfidence` number — Model recognition confidence, only when recognized by model
          - `modelClass` string — Model recognition class, only when recognized by model
          - `minDistance` integer — The closest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `maxDistance` integer — The farthest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `minHeight` integer — The maximum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `maxHeight` integer — The minimum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `start` integer, required — Start position in characters
          - `end` integer, required — End position in characters
          - `content` string, required — Text between start and end
        - GroupObject
          - `id` string, required — ID
          - `type` '3D_BOX' | '2D_BOX', required — Type, 3D_BOX, 2D_BOX, CHAT_THUMB, CLIP, DIALOG_EVALUATION, DIALOG_RESPONSE etc.
          - `createdBy` integer, required — Creator ID, ignored when importing
          - `createdAt` string, required — Create time, ignored when importing
          - `classId` integer, required — Class template ID, the template must exist in dataset when importing
          - `classVersion` integer, required — Class template version, optional, default to 1
          - `className` string, required — Class name, ignored when importing
          - `classValues` object[], required — Class values, may be nested, flatten into an array
            - `id` string
            - `attributeVersion` integer — 属性版本
            - `pid` integer
            - `pvalue` string
            - `name` string
            - `type` string
            - `value` string[] — Arrange from high to low according to the possibility
            - `alias` string
            - `isLeaf` boolean
          - `deviceName` string, required — Device name, used to distinguish different data files in multimodal data
          - `deviceFrame` integer — Frame of device, only exist when device contains multiple frames, for example, 4D point cloud data contains multiple images for a single camera
          - `groups` string[] — Groups, may be empty or multiple
          - `trackId` string — Tracking object ID
          - `trackName` string — Tracking object name
          - `modelConfidence` number — Model recognition confidence, only when recognized by model
          - `modelClass` string — Model recognition class, only when recognized by model
          - `minDistance` integer — The closest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `maxDistance` integer — The farthest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
          - `minHeight` integer — The maximum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
          - `maxHeight` integer — The minimum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
    - `relations` RelationObject[], required — Relation annotation objects
      - `id` string, required — ID
      - `type` '3D_BOX' | '2D_BOX', required — Type, 3D_BOX, 2D_BOX, CHAT_THUMB, CLIP, DIALOG_EVALUATION, DIALOG_RESPONSE etc.
      - `createdBy` integer, required — Creator ID, ignored when importing
      - `createdAt` string, required — Create time, ignored when importing
      - `classId` integer, required — Class template ID, the template must exist in dataset when importing
      - `classVersion` integer, required — Class template version, optional, default to 1
      - `className` string, required — Class name, ignored when importing
      - `classValues` object[], required — Class values, may be nested, flatten into an array
        - `id` string
        - `attributeVersion` integer — 属性版本
        - `pid` integer
        - `pvalue` string
        - `name` string
        - `type` string
        - `value` string[] — Arrange from high to low according to the possibility
        - `alias` string
        - `isLeaf` boolean
      - `deviceName` string, required — Device name, used to distinguish different data files in multimodal data
      - `deviceFrame` integer — Frame of device, only exist when device contains multiple frames, for example, 4D point cloud data contains multiple images for a single camera
      - `groups` string[] — Groups, may be empty or multiple
      - `trackId` string — Tracking object ID
      - `trackName` string — Tracking object name
      - `modelConfidence` number — Model recognition confidence, only when recognized by model
      - `modelClass` string — Model recognition class, only when recognized by model
      - `minDistance` integer — The closest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
      - `maxDistance` integer — The farthest distance to the original point at the XY plane, only for point cloud annotation object, automatically supplement when importing
      - `minHeight` integer — The maximum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
      - `maxHeight` integer — The minimum height on the Z axis, only for point cloud annotation object, automatically supplement when importing
      - `source` integer, required — Source entity id
      - `target` integer, required — Target entity id

---

[API](https://skmtc.dev/basic/apis/basicai-cloud-open-plugin-api.md) · [All operations](https://skmtc.dev/basic/apis/basicai-cloud-open-plugin-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/basic/basicai-cloud-open-plugin-api/revisions/f6b5a226c6da/schema)