---
title: "List knowledge store items"
method: GET
path: "/knowledge-stores/{knowledge_store_id}/items"
tags: ["knowledgeStoreItems"]
---

# List knowledge store items

`GET /knowledge-stores/{knowledge_store_id}/items`

This method returns a list of items in the specified knowledge store.

## Path parameters

- `knowledge_store_id` string, required

## Query parameters

- `page` integer
- `page_limit` integer
- `sort_by` 'created_at' | 'updated_at'
- `sort_option` string
- `status` KnowledgeStoresKnowledgeStoreIdItemsGetParametersStatusSchemaItems[]

## Headers

- `x-api-key` string, required

## Response `200`

The knowledge store items have been successfully retrieved.

- KnowledgeStoreItemsListResponse200
  - `data` KnowledgeStoreItem[] — An array containing the knowledge store items.
    - `_id` string — The unique identifier of the knowledge store item.
    - `asset_type` 'video' | 'image', required — The type of item in the knowledge store.
    - `asset_id` string — The unique identifier of the source asset.
    - `status` 'queued' | 'pending' | 'processing' | 'ready' | 'failed' — The processing status of the item. For the meaning of each value, see the [Item statuses](/v1.3/api-reference/knowledge-store-items/the-knowledge-store-item-object#item-statuses) section on **The knowledge store item object** page.
    - `system_metadata` union — System-generated media metadata for the source asset. Its `asset_type` field always matches the item's top-level `asset_type` field.
      - object — System-generated media metadata for a video item.
        - `asset_type` 'video', required — This field is always set to `video` for video items.
        - `filename` string — The original filename of the video.
        - `duration` number, double — The duration of the video in seconds.
        - `fps` number, double — The frame rate of the video in frames per second.
        - `width` integer — The width of the video in pixels.
        - `height` integer — The height of the video in pixels.
        - `codec_name` string — The codec used to encode the video.
        - `size` integer — The file size of the video in bytes.
      - object — System-generated media metadata for an image item.
        - `asset_type` 'image', required — This field is always set to `image` for image items.
        - `filename` string — The original filename of the image.
        - `width` integer — The width of the image in pixels.
        - `height` integer — The height of the image in pixels.
        - `codec_name` string — The codec used to encode the image.
        - `size` integer — The file size of the image in bytes.
    - `metadata` object — Custom metadata for the item.
    - `created_at` string, date-time — The date and time when the item was created, in the RFC 3339 format.
    - `updated_at` string, date-time — The date and time when the item was last updated, in the RFC 3339 format.
  - `page_info` PageInfo — An object that provides information about pagination.
    - `limit_per_page` integer — The maximum number of items on each page.
    - `page` integer — The page you retrieved.
    - `total_page` integer — The total number of pages.
    - `total_results` integer — The total number of results.

## Other responses

- `400` — The request has failed.

---

[API](https://skmtc.net/twelvelabs/apis/twelvelabs-api.md) · [All operations](https://skmtc.net/twelvelabs/apis/twelvelabs-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvelabs/twelvelabs-api/revisions/5dbd6e8473c9/schema)