---
title: "Query item (data, scene or batch) list of dataset"
method: GET
path: "/dataset/listItem/{datasetId}"
tags: ["Open API/Dataset"]
---

# Query item (data, scene or batch) list of dataset

`GET /dataset/listItem/{datasetId}`

Query the list of items (data, scenes, or batches) under the dataset, returning only the items at the current level.

## Path parameters

- `datasetId` string, required

## Query parameters

- `pageNo` integer
- `pageSize` integer
- `parentId` integer, nullable
- `name` string
- `type` string
- `startCreatedTime` string
- `endCreatedTime` string
- `sortBy` string
- `sortDirection` string

## Headers

- `Authorization` string

## Response `200`

Success

- object
  - `code` string, required — Error code, success will be OK
  - `message` string, required — Error message
  - `data` object, required
    - `pageSize` integer, required — Number of page records, value from 1 to 100, default to 10
    - `pageNo` integer, required — Current page number, default to 1
    - `total` integer, required — Total, only return in first page
    - `list` Item, required
      - `id` integer, required — ID
      - `datasetId` integer, required — Dataset ID
      - `name` string, required — Name
      - `parentId` integer, nullable, required — Parent ID, Batch ID or Scene ID
      - `size` integer — Size, in bytes, just for data
      - `lockedBy` string, nullable — Locked by who, just for data

---

[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)