---
title: "List knowledge store item collections"
method: GET
path: "/knowledge-stores/{knowledge_store_id}/item-collections"
tags: ["knowledgeStoreItemCollections"]
---

# List knowledge store item collections

`GET /knowledge-stores/{knowledge_store_id}/item-collections`

Returns a list of the item collections 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' | 'name'
- `sort_option` string

## Headers

- `x-api-key` string, required

## Response `200`

The item collections have been successfully retrieved.

- KnowledgeStoreItemCollectionsListResponse200
  - `data` KnowledgeStoreItemCollection[] — An array containing the item collections.
    - `_id` string — The unique identifier of the item collection.
    - `knowledge_store_id` string — The unique identifier of the knowledge store this collection belongs to.
    - `name` string — The name of the item collection.
    - `description` string — The description of the item collection.
    - `metadata` object — Custom metadata for the item collection. Keys are strings; each value is a string, a number, a boolean, or an array of strings.
    - `member_count` integer — The number of items in the collection.
    - `created_at` string, date-time — The date and time when the item collection was created, in the RFC 3339 format.
    - `updated_at` string, date-time — The date and time when the item collection 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.

## Changes

- **2026-09-02** `335e364dd9b5` — 1 breaking
  - response property `data/items/metadata/additionalProperties/` list-of-types was widened by adding types `array, boolean, integer and number` to media type `application/json` of response `200`
- **2026-07-31** `5dbd6e8473c9` — 1 warning
  - removed the optional property `docs_url` from the response with the `400` status
- **2026-07-26** `c0926990c662` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/knowledge-stores/:knowledge_store_id/item-collections/get.md)

---

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